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

IltmmCapture *pCapture

Pointer to an IltmmCapture interface.

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

Platforms

Win32, x64.

See Also

Functions

Topics

Help Version 23.0.2024.2.29
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2024 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2023 LEAD Technologies, Inc. All Rights Reserved.