Microsoft DirectX 8.1 (C++)

IMediaDet::WriteBitmapBits

The WriteBitmapBits method retrieves a poster frame at the specified media time and writes it to a file.

Syntax

HRESULT WriteBitmapBits(
    double StreamTime, 
    long Width, 
    long Height, 
    BSTR Filename 
);

Parameters

StreamTime

Time at which to retrieve the poster frame.

Width

Width of the poster frame image, in pixels.

Height

Height of the poster frame image, in pixels.

Filename

Path of the file in which to save the poster frame. If the file already exists, this method overwrites it.

Return Value

Returns S_OK it successful. Otherwise, returns an HRESULT value that indicates the cause of the error. Possible error codes include the following:

Value Description
E_NOINTERFACE Could not add the Sample Grabber filter to the graph.
E_FAIL Failure.
E_OUTOFMEMORY Insufficient memory.
E_UNEXPECTED Unexpected error.
STG_E_ACCESSDENIED Cannot overwrite file.
VFW_E_INVALIDMEDIATYPE Invalid media type.

Remarks

Before calling this method, set the file name and stream by calling IMediaDet::put_Filename and IMediaDet::put_CurrentStream.

This method puts the media detector into bitmap grab mode. Once this method has been called, the various stream information methods in IMediaDet do not work, unless you create a new instance of the media detector.

See Also