In This Topic ▼

IltmmConvert::get_StillCaptureLimit

Summary

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

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmConvert_get_StillCaptureLimit(pConvert, pVal)
C++	HRESULT get_StillCaptureLimit(pVal)

Parameters

IltmmConvert *pConvert

Pointer to an IltmmConvert interface.

long *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

Value	Meaning
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.