IMFMediaEngine::Muat metode (mfmediaengine.h)

Memuat sumber media saat ini.

Sintaks

HRESULT Load();

Mengembalikan nilai

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

Keterangan

Tujuan utama dari metode ini adalah untuk memuat ulang daftar elemen sumber setelah memperbarui daftar. Untuk informasi selengkapnya, lihat SetSourceElements. Jika tidak, memanggil metode ini umumnya tidak diperlukan. Untuk memuat sumber media baru, panggil IMFMediaEngine::SetSource atau IMFMediaEngine::SetSourceElements.

Metode Muat secara eksplisit memanggil algoritma pemuatan sumber daya media Mesin Media. Sebelum memanggil metode ini, Anda harus mengatur sumber daya media dengan memanggil IMFMediaEngine::SetSource atau IMFMediaEngine::SetSourceElements.

Metode ini selesai secara asinkron. Saat operasi Muat dimulai, Mesin Media mengirimkan peristiwa MF_MEDIA_ENGINE_EVENT_LOADSTART . Jika tidak ada kesalahan yang terjadi selama operasi Muat , beberapa peristiwa lain dihasilkan, termasuk yang berikut ini.

  • MF_MEDIA_ENGINE_EVENT_LOADEDMETADATA
  • MF_MEDIA_ENGINE_EVENT_LOADEDDATA
  • MF_MEDIA_ENGINE_EVENT_CANPLAY
  • MF_MEDIA_ENGINE_EVENT_CANPLAYTHROUGH
Jika Mesin Media tidak dapat memuat file, Mesin Media akan mengirimkan peristiwa MF_MEDIA_ENGINE_EVENT_ERROR .

Untuk informasi selengkapnya tentang penanganan peristiwa di Mesin Media, lihat IMFMediaEngineNotify.

Metode ini sesuai dengan metode beban antarmuka HTMLMediaElement dalam HTML5.

Persyaratan

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

IMFMediaEngine