In This Topic ▼

IltmmCapture::put_StillTap

Summary

Sets the position, in the stream, where the still images are tapped from.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmCapture_put_StillTap(pCapture, newVal)
C++	HRESULT put_StillTap(newVal)

Parameters

ltmmCapture_StillTap newVal

Value that is one of the ltmmCapture_StillTap enumeration constants.

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

This property indicates where the still image should be captured from. Some capture devices have a still pin, usually it is present when they have a hardware button that can also serve as a trigger for a capture.

When the StillTap property is set to ltmmCapture_StillTap (indicating the still image should be captured from the still pin), the capture occurs when the hardware button is pressed. If there isn't a button or the user does not press the button, the capture occurs after the timeout specified.

When the StillTap property is not ltmmCapture_StillTap (indicating the still image should be grabbed from the capture pin or from the processors), the capture occurs after the timeout specified.

In both cases, the timeout is passed as an argument (IltmmCapture::GetStillDIB, IltmmCapture::GetStillPicture, IltmmCapture::SaveStillDIB, IltmmCapture::SaveStillBitmap) or through the IltmmCapture::put_CaptureStillDelay property (IltmmCapture::CaptureHDib and IltmmCapture::CapturePicture).

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.

IltmmCapture::put_StillTap

Summary

Syntax

Parameters

IltmmCapture *pCapture

ltmmCapture_StillTap newVal

Returns

Comments

Required DLLs and Libraries

Platforms

See Also

Functions

Topics