| Microsoft DirectX 9.0 |
The EnterBitmapGrabMode method switches the media detector to bitmap grab mode and seeks the filter graph to a specified time.
Syntax
HRESULT EnterBitmapGrabMode(
double StreamTime
);
Parameters
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. |
Remarks
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.
Requirements
Header: Include Qedit.h. This header file is not compatible with Microsoft® Direct3D® headers later than version 7.
Library: Use strmiids.lib.
See Also