Fungsi MFCreateVideoRendererActivate (mfidl.h)

Artikel
02/28/2024

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.

Nilai kembali

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

Persyaratan	Nilai
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

Bagikan melalui