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