Collapse All Expand All

IltmmCapture::put_StillTap

#include "ltmm.h"

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

 

IltmmCapture *pCapture;	/* pointer to an interface */
ltmmCapture_StillTap newVal;	/* flag */

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

Parameter	Description
pCapture	Pointer to an IltmmCapture interface.
newVal	Value that is one of the ltmmCapture_StillTap enumeration constants.

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

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 doesn't 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::CaptureDib 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

See Also

Elements:	IltmmCapture::get_StillTap, ltmmCapture_StillTap Constants, IltmmCapture::GetStillDIB, IltmmCapture::GetStillPicture, IltmmCapture::SaveStillDIB, IltmmCapture::SaveStillBitmap, IltmmCapture::CaptureDib, IltmmCapture::CapturePicture, IltmmCapture::put_CaptureStillDelay, IltmmCapture::get_CaptureStillDelay
Topics:	Multimedia Function Group