Collapse All Expand All

IltmmConvert::put_StillCaptureLimit

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_put_StillCaptureLimit(pConvert, newVal)
C++ Syntax	HRESULT put_StillCaptureLimit(newVal)

 

IltmmConvert *pConvert;	/* pointer to an interface */
DWORD newVal;	/* time limit */

Sets the time limit, in milliseconds, for still image capturing.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
newVal	Value that represents the time limit, in milliseconds, for still image capturing.

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

If the media samples' time exceeds this value, calling the IltmmConvert::SaveStillBitmap function will return the last captured image (old). The default value is 1000 milliseconds.

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.

Platforms

Win32, x64

See Also

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

Example

For a C example, refer to IltmmConvert::get_EnableStillCapture

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