IMFMediaEngineClassFactory::Metode CreateInstance (mfmediaengine.h)
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 |
---|---|
|
Berhasil. |
|
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 . |
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: 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: | Opsional. | Opsional. | Opsional. |
Pemutaran audio | Salah satu hal berikut ini: | 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 |