Microsoft DirectX 9.0


The EnterBitmapGrabMode method switches the media detector to bitmap grab mode and seeks the filter graph to a specified time.


HRESULT EnterBitmapGrabMode(
    double StreamTime



Time, in seconds, to which the graph seeks.

Return Value

Returns an HRESULT value. Possible values include the following:

Value Description
S_OK Success.
E_INVALIDARG Invalid argument.
VFW_E_INVALIDMEDIATYPE The source file does not have a video stream.
VFW_E_TIME_EXPIRED Could not seek the graph.


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

This method inserts the Sample Grabber filter into the filter graph. You can then call IMediaDet::GetSampleGrabber to obtain a pointer to the ISampleGrabber interface. Once the media detector enters bitmap grab mode, the various informational methods in IMediaDet do not work.

The IMediaDet::GetBitmapBits or IMediaDet::WriteBitmapBits methods also put the media detector into bitmap grab mode.


Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.

Library: Use strmiids.lib.

See Also