IMFMediaEngineClassFactory::Metode CreateInstance (mfmediaengine.h)

Artikel
03/15/2023

Membuat instans baru Mesin Media.

Sintaks

HRESULT CreateInstance(
  [in]  DWORD          dwFlags,
  [in]  IMFAttributes  *pAttr,
  [out] IMFMediaEngine **ppPlayer
);

Parameter

[in] dwFlags

Bitwise OR dari nol atau lebih bendera dari enumerasi MF_MEDIA_ENGINE_CREATEFLAGS .

[in] pAttr

Penunjuk ke antarmuka IMFAttributes dari penyimpanan atribut.

Parameter ini menentukan atribut konfigurasi untuk Mesin Media. Panggil MFCreateAttributes untuk membuat penyimpanan atribut. Kemudian, atur satu atau beberapa atribut dari daftar Atribut Mesin Media. Untuk detailnya, lihat Keterangan.

[out] ppPlayer

Menerima pointer ke antarmuka IMFMediaEngine . Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
MF_E_ATTRIBUTENOTFOUND	Atribut yang diperlukan hilang dari pAttr, atau kombinasi atribut yang tidak valid digunakan.

Keterangan

Sebelum memanggil metode ini, panggil MFStartup.

Mesin Media mendukung tiga mode yang berbeda:

Mode	Deskripsi
Mode frame-server	Dalam mode ini, Mesin Media memberikan bingkai video yang tidak dikompresi ke aplikasi. Aplikasi ini bertanggung jawab untuk menampilkan setiap bingkai, menggunakan Microsoft Direct3D atau teknik penyajian lainnya. Mesin Media merender audio; aplikasi tidak bertanggung jawab atas penyajian audio. Mode frame-server adalah mode default.
Mode penyajian	Dalam mode ini, Media Engine merender audio dan video. Video dirender ke jendela atau visual Microsoft DirectComposition yang disediakan oleh aplikasi. Untuk mengaktifkan mode penyajian, atur atribut MF_MEDIA_ENGINE_PLAYBACK_HWND atau atribut MF_MEDIA_ENGINE_PLAYBACK_VISUAL .
Mode audio	Dalam mode ini, Mesin Media hanya merender audio, tanpa video. Untuk mengaktifkan mode audio, atur bendera MF_MEDIA_ENGINE_AUDIOONLY di parameter dwFlags .

Mode

Deskripsi

Mode frame-server

Dalam mode ini, Mesin Media memberikan bingkai video yang tidak dikompresi ke aplikasi. Aplikasi ini bertanggung jawab untuk menampilkan setiap bingkai, menggunakan Microsoft Direct3D atau teknik penyajian lainnya.

Mesin Media merender audio; aplikasi tidak bertanggung jawab atas penyajian audio.

Mode frame-server adalah mode default.

Mode penyajian

Dalam mode ini, Media Engine merender audio dan video. Video dirender ke jendela atau visual Microsoft DirectComposition yang disediakan oleh aplikasi.

Untuk mengaktifkan mode penyajian, atur atribut MF_MEDIA_ENGINE_PLAYBACK_HWND atau atribut MF_MEDIA_ENGINE_PLAYBACK_VISUAL .

Mode audio

Dalam mode ini, Mesin Media hanya merender audio, tanpa video.

Untuk mengaktifkan mode audio, atur bendera MF_MEDIA_ENGINE_AUDIOONLY di parameter dwFlags .

Atribut Inisialisasi

Atribut berikut didefinisikan untuk parameter pAttr . Beberapa diperlukan, dan beberapa bersifat opsional, tergantung pada mode yang Anda inginkan.

Fitur	Atribut	Mode Server Bingkai	Mode Penyajian	Audio Mode
Panggilan balik peristiwa	MF_MEDIA_ENGINE_CALLBACK	Wajib diisi.	Wajib diisi.	Wajib diisi.
Render target	Salah satu dari berikut ini: MF_MEDIA_ENGINE_PLAYBACK_HWND MF_MEDIA_ENGINE_PLAYBACK_VISUAL Atribut ini saling eksklusif. Mengatur salah satu atribut ini menempatkan Mesin Media ke dalam mode penyajian.	Jangan disetel.	Wajib diisi.	Jangan disetel.
Format Direct3D	MF_MEDIA_ENGINE_VIDEO_OUTPUT_FORMAT	Wajib diisi.	Opsional.	Jangan disetel.
Manajer perangkat Microsoft DirectX Graphics Infrastructure (DXGI)	MF_MEDIA_ENGINE_DXGI_MANAGER	Opsional.	Opsional.	Jangan disetel.
Ekstensi Mesin Media	MF_MEDIA_ENGINE_EXTENSION	Opsional.	Opsional.	Opsional.
Proteksi konten	Salah satu hal berikut ini: MF_MEDIA_ENGINE_OPM_HWND MF_MEDIA_ENGINE_CONTENT_PROTECTION_FLAGS MF_MEDIA_ENGINE_CONTENT_PROTECTION_MANAGER	Opsional.	Opsional.	Opsional.
Pemutaran audio	Salah satu hal berikut ini: MF_MEDIA_ENGINE_AUDIO_CATEGORY MF_MEDIA_ENGINE_AUDIO_ENDPOINT_ROLE	Opsional.	Opsional.	Opsional.

Windows Phone 8

API ini didukung.

Di ponsel, Mesin Media hanya mendukung mode frame-server. Mencoba menginisialisasi antarmuka dalam mode penyajian atau mode audio akan gagal.

Persyaratan


Klien minimum yang didukung	Windows 8 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2012 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfmediaengine.h

Lihat juga

IMFMediaEngineClassFactory

Bagikan melalui