IltmmConvert::put_Preview

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert__put_Preview(pConvert, newVal)

C++ Syntax

HRESULT put_Preview(newVal)

 

IltmmConvert *pConvert;

/* pointer to an interface */

VARIANT_BOOL newVal;

/* flag */

Adds or removes the preview graph for the convert graph.

Parameter

Description

pConvert

Pointer to an IltmmConvert interface.

newVal

Flag that indicates whether to add or remove the preview graph from the convert graph. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

Add the preview graph.

 

VARIANT_FALSE

Remove the preview graph. This is the default value.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

Adding the preview graph in the convert graph will enable previewing the stream while converting.

To add or remove the preview graph, the convert graph must be in the stopped state.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Functions:

IltmmConvert::get_Preview, IltmmConvert::put_PreviewVisible, IltmmConvert::get_PreviewVisible, IltmmConvert::put_VideoWindowFrame, IltmmConvert::get_VideoWindowFrame

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::put_Preview Example for C.

For a C++ example, refer to IltmmConvert::put_Preview Example for C++.