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

Elements:	IltmmConvert::get_EnableStillCapture, IltmmConvert::SaveStillBitmap
Topics:	Multimedia Function Group