Fungsi MFCreateVideoRendererActivate (mfidl.h)

Membuat objek aktivasi untuk sink media perender video (EVR) yang disempurnakan.

Sintaks

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

Parameter

[in] hwndVideo

Tangani ke jendela tempat video akan ditampilkan.

[out] ppActivate

Menerima penunjuk ke antarmuka IMFActivate . Gunakan antarmuka ini untuk membuat EVR. Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Fungsi mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
Metode berhasil.

Keterangan

Untuk membuat EVR, panggil IMFActivate::ActivateObject pada penunjuk IMFActivate yang diambil. (Jika Anda menggunakan Sesi Media, Sesi Media secara otomatis memanggil ActivateObject saat Anda mengantre topologi.)

Untuk mengonfigurasi EVR, atur salah satu atribut berikut pada objek IMFActivate sebelum memanggil ActivateObject.

Atribut Deskripsi
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_ACTIVATE Objek aktivasi untuk mixer kustom.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_CLSID CLSID untuk mixer kustom.
MF_ACTIVATE_CUSTOM_VIDEO_MIXER_FLAGS Bendera untuk membuat mixer kustom.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_ACTIVATE Objek aktivasi untuk penyaji kustom.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_CLSID CLSID untuk penyaji kustom.
MF_ACTIVATE_CUSTOM_VIDEO_PRESENTER_FLAGS Bendera untuk membuat penyaji kustom.
 

Ketika IMFActivate::ActivateObject dipanggil, objek aktivasi mengatur jendela video pada EVR dengan memanggil IMFVideoDisplayControl::SetVideoPosition. Meneruskan NULL untuk parameter hwndVideo bukanlah kesalahan, tetapi tidak ada video yang akan dirender kecuali EVR memiliki jendela video yang valid.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header mfidl.h
Pustaka Mf.lib
DLL Mf.dll

Lihat juga

Objek Aktivasi

Perender Video yang Disempurnakan

Fungsi Media Foundation