IMediaDet::EnterBitmapGrabMode

  • Article
 
Microsoft DirectShow 9.0

IMediaDet::EnterBitmapGrabMode

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 Seek command timed out.

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