IltmmConvert::put_EnableStillCapture

#include "ltmm.h"

C Syntax

HRESULT IltmmConvert__put_EnableStillCapture(pConvert, newVal)

C++ Syntax

HRESULT put_EnableStillCapture(newVal)

 

IltmmConvert *pConvert;

/* pointer to an interface */

VARIANT_BOOL newVal;

/* boolean value */

Enables or disables the capturing of still images during conversion.

Parameter

Description

pConvert

Pointer to an IltmmConvert interface.

newVal

Value that indicates whether still images can be captured during conversion. Possible values are:

 

Value

Meaning

 

VARIANT_TRUE

Enables capturing still images during conversion. (using IltmmConvert::SaveStillBitmap).

 

VARIANT_FALSE

Disables capturing still images during conversion. 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

In order to capture still images during conversion, this function must be called before calling the IltmmConvert::SaveStillBitmap function, with setting the value of newVal parameter to VARIANT_TRUE.

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

Elements:

IltmmConvert::get_EnableStillCapture, IltmmConvert::SaveStillBitmap

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::get_EnableStillCapture

For a C++ example, refer to IltmmConvert::get_EnableStillCapture