共用方式為


MFCreateVideoRendererActivate 函式 (mfidl.h)

為增強的視訊轉譯器建立啟用物件, (EVR) 媒體接收。

語法

HRESULT MFCreateVideoRendererActivate(
  [in]  HWND        hwndVideo,
  [out] IMFActivate **ppActivate
);

參數

[in] hwndVideo

將顯示視訊的視窗句柄。

[out] ppActivate

接收 IMFActivate 介面的指標。 使用此介面來建立 EVR。 呼叫端必須釋放 介面。

傳回值

函式會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。

備註

若要建立 EVR,請在擷取的 IMFActivate 指標上呼叫 IMFActivate::ActivateObject。 (如果您使用媒體會話,當您將拓撲排入佇列時,媒體會話會自動呼叫 ActivateObject 。)

若要設定 EVR,請先在 IMFActivate 對象上設定下列任何屬性,再呼叫 ActivateObject

屬性 Description
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE 自定義混合器的啟用物件。
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID 自定義混合器的CLSID。
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS 用來建立自定義混合器的旗標。
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE 自定義演示者的啟用物件。
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID 自定義演示者的 CLSID。
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS 用來建立自定義演示者的旗標。
 

呼叫 IMFActivate::ActivateObject 時,啟用物件會呼叫 IMFVideoDisplayControl::SetVideoPosition,在 EVR 上設定視訊視窗。 傳遞 hwndVideo 參數的 NULL 不是錯誤,但除非 EVR 有有效的視訊視窗,否則不會轉譯任何視訊。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mf.lib
Dll Mf.dll

另請參閱

啟用物件

增強的視訊轉譯器

媒體基礎函式