In This Topic ▼

IltmmConvert::put_StillCaptureLimit

Summary

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

Syntax

#include "ltmm.h"

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

Parameters

IltmmConvert *pConvert

Pointer to an IltmmConvert interface.

long newVal

Value that represents the time limit, in milliseconds, for still image capturing.

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

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.