IMediaDet：：WriteBitmapBits 方法

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

注意

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

 

方法 WriteBitmapBits 會在指定的媒體時間擷取視訊畫面，並將它寫入檔案。 視訊框架一律為 24 位 RGB 格式。

語法

HRESULT WriteBitmapBits(
   double StreamTime,
   long   Width,
   long   Height,
   BSTR   Filename
);

參數

StreamTime

擷取視訊畫面的時間。

寬度

影像的寬度，以圖元為單位。

高度

影像的高度，以圖元為單位。

檔案名稱

要在其中儲存點陣圖的檔案路徑。 如果檔案已經存在，這個方法就會覆寫它。

傳回值

傳回成功S_OK。 否則，會傳回 HRESULT 值，指出錯誤的原因。 可能的錯誤碼包括：

傳回碼	Description
E_NOINTERFACE	無法將 範例擷取器 篩選新增至圖形。
E_FAIL	失敗。
E_OUTOFMEMORY	記憶體不足。
E_UNEXPECTED	非預期的錯誤。
STG_E_ACCESSDENIED	無法覆寫檔案。
VFW_E_INVALIDMEDIATYPE	不正確媒體類型。

 

備註

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

這個方法會將媒體偵測器放入點陣圖抓取模式。 呼叫此方法之後，除非建立媒體偵測器的新實例， 否則 IMediaDet 中的各種串流資訊方法無法運作。

注意

標頭檔 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 介面

錯誤和成功碼