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.

See Also

Elements:

IltmmConvert::get_EnableStillCapture, IltmmConvert::get_StillCaptureLimit, IltmmConvert::put_EnableStillCapture, IltmmConvert::put_StillCaptureLimit

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmConvert::get_EnableStillCapture

For a C++ example, refer to IltmmConvert::get_EnableStillCapture