IltmmConvert::get_StillCaptureLimit

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert__get_StillCaptureLimit(pConvert, pVal)
C++ Syntax	HRESULT get_StillCaptureLimit(pVal)

IltmmConvert *pConvert;	/* pointer to an interface */
DWORD *pVal;	/* pointer to a variable */

Retrieves the time limit, in milliseconds, for capturing a still image.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
pVal	Pointer to a variable to be updated with the time limit, in milliseconds, for capturing a still image. The default value is 1000.

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

Time limit is the time that no frames can be captured after its end. For example, if the value of pVal parameter is 5000ms, this mean no frames cab be captured after 5 seconds of conversion.

Use the IltmmConvert::get_EnableStillCapture function to retrieve a value that indicates whether still images can be captured during conversion. Use the IltmmConvert::get_StillCaptureLimit function to retrieve the time limit, in milliseconds, for capturing a still image. Use the IltmmConvert::put_EnableStillCapture function to enable or disable the capturing of still images during conversion. Use the IltmmConvert::put_StillCaptureLimit function to set the time limit, in milliseconds, for still image capturing. Use the IltmmConvert::SaveStillBitmap function to save a snapshot from the running stream to a file, as a bitmap.

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.

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