Microsoft DirectX 9.0

MediaDet.WriteBitmapBits Method

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


    StreamTime As Double, 
    Width As Long, 
    Height As Long, 
    Filename As String



Time at which to retrieve the poster frame, in seconds.


Width of the poster frame image, in pixels.


Height of the poster frame image, in pixels.


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

Error Codes

If the method fails, an error is raised, and Err.Number can be set to one of the following values:

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.


Before calling this method, set the Filename and CurrentStream properties.

This method puts the MediaDet object 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 object.

See Also