IltmmConvert::SaveStillBitmap

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_SaveStillBitmap(pConvert, Filename, Format, Quality, Flags, Timeout)
C++ Syntax	HRESULT SaveStillBitmap(Filename, Format, Quality, Flags, Timeout)

IltmmConvert *pConvert;	/* pointer to an interface */
BSTR filename;	/* file name */
long Format;	/* format */
long Quality;	/* compression quality */
long Flags;	/* flags */
long Timeout;	/* timeout */

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

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
Filename	A character string that contains the name of the file in which to save the bitmap.
Format	Value that represents the output file format. For a list of possible values, refer to ltmmConvert_StillFormat Constants.
Quality	Value that represents the compression quality. This is used only when the Format parameter is ltmmConvert_StillFormat_CMP. For a list of possible values, refer to Compression Quality Factors.
Flags	Not used. Pass 0.
Timeout	The timeout period, in milliseconds. The function will fail if it was not able to take a sample in the specified time. Use –1 to wait indefinitely until a sample is snapped

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

Use the IltmmConvert::get_EnableStillCapture function to retrieve a value that indicates whether still images can be captured during conversion. Use the IltmmConvert::get_StillCaptureLimit function to retrieve the time limit, in milliseconds, for capturing a still image. Use the IltmmConvert::put_EnableStillCapture function to enable or disable the capturing of still images during conversion. Use the IltmmConvert::put_StillCaptureLimit function to set the time limit, in milliseconds, for still image capturing. Use the IltmmConvert::SaveStillBitmap function to save a snapshot from the running stream to a file, as a bitmap.

If the passed file name to the Filename parameter is NULL, then the function will return an error.

If the passed file name to the Filename parameter currently exists, then the existing file will be overwritten.

In order to save a snapshot from the running stream to a file, before calling this function the user must call IltmmConvert::put_EnableStillCapture with setting the value of newVal parameter to VARIANT_TRUE; otherwise this function will return an error.

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.

Elements:	IltmmConvert::get_EnableStillCapture, IltmmConvert::get_StillCaptureLimit, IltmmConvert::put_EnableStillCapture, IltmmConvert::put_StillCaptureLimit
Topics:	Multimedia Function Group