| Microsoft DirectX 8.1 (C++) |
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 | File does not have a video stream. |
| VFW_E_TIME_EXPIRED | Could not seek. |
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.
See Also