In This Topic ▼

IltmmCapture::SaveStillDIB

Summary

Saves a snapshot as a DIB, from the running stream to a file.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmCapture_SaveStillDIB(pCapture, filename, timeout)
C++	HRESULT SaveStillDIB(filename, timeout)

Parameters

IltmmCapture *pCapture

Pointer to an IltmmCapture interface.

BSTR filename

A character string containing the name of the file in which to save the DIB.

long timeout

The timeout period in milliseconds. The method will fail if it was not able to take a DIB in the specified time. Use 1 to wait indefinitely until a DIB is snapped.

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 method blocks (does not return) until the timeout occurs or the DIB is snapped.

The frame is captured from the position indicated by the StillTap property.

When capturing from the still pin, the capture happens when the user presses the hardware button for capturing the still image.

If there is not a hardware button or the user does not press it, the capture occurs after the timeout specified by the TimeOut parameter.

When not capturing from the still pin, the capture occurs after the amount of time specified by the TimeOut parameter.

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.

Example

Language	Example
C	IltmmCapture::SaveStillDIB
C++	IltmmCapture::SaveStillDIB

Download our FREE evaluation

Help Version 22.0.2023.1.26

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