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. |
See Also
|
Elements: |
IltmmConvert::get_StillCaptureLimit, IltmmConvert::get_EnableStillCapture |
|
Topics: |
Example
For a C example, refer to IltmmConvert::get_EnableStillCapture
For a C++ example, refer to IltmmConvert::get_EnableStillCapture