IMediaDet::EnterBitmapGrabMode 方法

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼,以使用新的 API。]

注意

[已被取代。 此 API 可能會從未來的 Windows 版本中移除。]

 

方法會將 EnterBitmapGrabMode 媒體偵測器切換為點陣圖抓取模式,並將篩選圖形搜尋至指定的時間。

語法

HRESULT EnterBitmapGrabMode(
   double StreamTime
);

參數

StreamTime

圖形所搜尋的時間,以秒為單位。

傳回值

傳回 HRESULT 值。 可能的值如下:

傳回碼 描述
S_OK
成功。
E_INVALIDARG
無效引數。
VFW_E_INVALIDMEDIATYPE
來源檔案沒有視訊串流。
VFW_E_TIME_EXPIRED
Seek 命令逾時。

 

備註

呼叫此方法之前,請先呼叫 IMediaDet::p ut_FilenameIMediaDet::p ut_CurrentStream來設定檔案名和資料流程。

這個方法會將 Sample Grabber 篩選插入篩選圖形中。 接著,您可以呼叫 IMediaDet::GetSampleGrabber 來取得 ISampleGrabber 介面的指標。 一旦媒體偵測器進入點陣圖抓取模式, IMediaDet 中的各種資訊方法將無法運作。

IMediaDet::GetBitmapBitsIMediaDet::WriteBitmapBits方法也會讓媒體偵測器進入點陣圖抓取模式。

注意

標頭檔 Qedit.h 與 7 版之後的 Direct3D 標頭不相容。

 

注意

若要取得 Qedit.h,請下載適用于 Windows Vista 的 Microsoft Windows SDK Update 和 .NET Framework 3.0。 Windows 7 和 .NET Framework 3.5 Service Pack 1 Microsoft Windows SDK中無法使用 Qedit.h。

 

規格需求

需求
標頭
Qedit.h
程式庫
Strmiids.lib

另請參閱

IMediaDet 介面

錯誤和成功碼