In This Topic ▼

IltmmCapture::put_CaptureStillDelay

#include "ltmm.h"

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

IltmmCapture *pCapture;	pointer to an interface
long newVal;	time delay value

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

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.
newVal	Value that represents the time delay, in milliseconds. The default value is zero.

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

This property affects the amount of time it takes to capture a still image using the IltmmCapture::CaptureDIB 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::CaptureDIB 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.

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.

Win32, x64