| Microsoft DirectX 8.1 (C++) |
The MediaDet.WriteBitmapBits method retrieves a poster frame at the specified media time and writes it to a file.
Syntax
object.WriteBitmapBits(
StreamTime As Double,
Width As Long,
Height As Long,
Filename As String
)
Parameters
StreamTime
Time at which to retrieve the poster frame, in seconds.
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.
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. |
Remarks
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