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

Help Version 19.0.2017.10.27
Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.
LEADTOOLS Multimedia C API Help