Fungsi MFPCreateMediaPlayer (mfplay.h)

Artikel
08/24/2023

Penting Usang. API ini dapat dihapus dari rilis Windows mendatang. Aplikasi harus menggunakan Sesi Media untuk pemutaran.

Membuat instans baru objek pemutar MFPlay.

Sintaks

HRESULT MFPCreateMediaPlayer(
  [in]  LPCWSTR                 pwszURL,
  [in]  BOOL                    fStartPlayback,
  [in]  MFP_CREATION_OPTIONS    creationOptions,
  [in]  IMFPMediaPlayerCallback *pCallback,
  [in]  HWND                    hWnd,
  [out] IMFPMediaPlayer         **ppMediaPlayer
);

Parameter

[in] pwszURL

String yang dihentikan null yang berisi URL file media yang akan dibuka. Parameter ini bisa NULL. Jika parameter adalah NULL, fStartPlayback harus FALSE.

Jika parameter ini NULL, Anda dapat membuka URL nanti dengan memanggil IMFPMediaPlayer::CreateMediaItemFromURL.

[in] fStartPlayback

Jika TRUE, pemutaran dimulai secara otomatis. Jika FALSE, pemutaran tidak dimulai sampai aplikasi memanggil IMFMediaPlayer::P lay.

Jika pwszURL adalah NULL, parameter ini diabaikan.

[in] creationOptions

Bitwise ATAU nol dari lebih banyak bendera dari enumerasi _MFP_CREATION_OPTIONS .

[in] pCallback

Arahkan ke antarmuka IMFPMediaPlayerCallback dari objek panggilan balik, yang diimplementasikan oleh aplikasi. Gunakan antarmuka ini untuk mendapatkan pemberitahuan peristiwa dari objek pemutar MFPlay. Parameter ini bisa NULL. Jika parameter adalah NULL, aplikasi tidak akan menerima pemberitahuan peristiwa dari objek pemutar.

[in] hWnd

Handel ke jendela tempat video akan muncul. Untuk pemutaran audio saja, parameter ini bisa null.

Jendela yang ditentukan oleh hWnd digunakan untuk aliran video pertama yang dipilih di sumbernya. Jika sumber memiliki beberapa aliran video, Anda harus memanggil IMFPMediaItem::SetStreamSink untuk merender salah satu aliran video setelah yang pertama.

Jika hWndadalah NULL, MFPlay tidak akan menampilkan video apa pun kecuali aplikasi memanggil IMFPMediaItem::SetStreamSink untuk menentukan sink media untuk streaming video.

[out] ppMediaPlayer

Menerima pointer ke antarmuka IMFPMediaPlayer . Pemanggil harus merilis antarmuka. Parameter ini bisa NULL. Jika parameter ini NULL, fStartPlayback harus TRUE dan pwszURL tidak boleh NULL.

Nilai kembali

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Sebelum memanggil fungsi ini, panggil CoIntialize(Ex) dari utas yang sama untuk menginisialisasi pustaka COM.

Secara internal, MFPCreateMediaPlayer memanggil MFStartup untuk menginisialisasi platform Microsoft Media Foundation. Ketika objek pemutar dihancurkan, ia memanggil MFShutdown untuk mematikan platform. Aplikasi tidak perlu memanggil MFStartup atau MFShutdown saat menggunakan MFPlay.

Catatan Jika Anda menggunakan API Media Foundation lainnya di luar waktu hidup objek pemutar, maka aplikasi Anda harus memanggil MFStartup dan MFShutdown.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfplay.h
Pustaka	Mfplay.lib
DLL	Mfplay.dll

Lihat juga

Fungsi Media Foundation

Menggunakan MFPlay untuk Pemutaran Audio/Video

Share via