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 有有效的視訊視窗，否則不會轉譯任何視訊。