In This Topic ▼

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 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::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

Download our FREE evaluation

Help Version 21.0.2021.7.19

Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing