In This Topic ▼

IltmmCapture::put_CaptureStillDelay

Summary

Sets the time delay, in milliseconds, before capturing a DIB or a Picture.

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmCapture_put_CaptureStillDelay(pCapture, newVal)
C++	HRESULT put_CaptureStillDelay(newVal)

Pointer to an IltmmCapture interface.

Value that represents the time delay, in milliseconds. The default value is zero.

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.

This property affects the amount of time it takes to capture a still image using the IltmmCapture::CaptureHDIB and IltmmCapture::CapturePicture.

The meaning of the property is affected by the StillTap property:

When capturing from the still pin, the capture happens when the user presses the hardware button for capturing the still image. If there is not a hardware button or the user does not press it, the capture occurs after the timeout specified by this function.
When not capturing from the still pin, the capture occurs after the amount of time specified by this function. IltmmCapture::CaptureHDIB and IltmmCapture::CapturePicture wait the amount of time set by this function before grabbing a sample. Using the time delay is beneficial when using a capture device that creates poor quality frames when it first starts capturing.

To get the current time delay, call IltmmCapture::get_CaptureStillDelay.