共用方式為


IVMRFilterConfig::SetImageCompositor 方法 (strmif.h)

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

方法 SetImageCompositor 會安裝應用程式提供的映像撰寫器。

語法

HRESULT SetImageCompositor(
  [in] IVMRImageCompositor *lpVMRImgCompositor
);

參數

[in] lpVMRImgCompositor

影像撰寫器的 IVMRImageCompositor 介面指標。

傳回值

如果方法成功,它會傳回 S_OK。 如果方法失敗,則會傳回錯誤碼。

傳回碼 Description
VFW_E_WRONG_STATE
混合器目前未載入。

備註

使用這個方法,將 VMR 的預設撰寫器取代為應用程式所提供的自定義撰寫器。 影像組合器是混合器的子元件。

當 VMR 處於無視窗模式或視窗模式時,會自動載入撰寫器。 當 VMR 處於無轉譯模式時,必須呼叫 IVMRFilterConfig::SetNumberOfStreams 來載入撰寫器。 VMR 會管理 IVMRImageCompositor 介面上的所有參考計數。

規格需求

需求
最低支援的用戶端 具有 SP1 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限傳統型應用程式]
目標平台 Windows
標頭 strmif.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IVMRFilterConfig 介面

使用影片混合轉譯器