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.

See Also

Elements:

IltmmConvert::put_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