IMFMediaEventGenerator::Metode GetEvent (mfobjects.h)

  • Artikel

Mengambil peristiwa berikutnya dalam antrean. Metode ini sinkron.

Sintaks

HRESULT GetEvent(
  [in]  DWORD         dwFlags,
  [out] IMFMediaEvent **ppEvent
);

Parameter

[in] dwFlags

Menentukan salah satu nilai berikut.

Nilai Makna
0
 Metode memblokir hingga generator peristiwa mengantre peristiwa.
MF_EVENT_FLAG_NO_WAIT
 Metode segera kembali.

[out] ppEvent

Menerima pointer ke antarmuka IMFMediaEvent . Pemanggil harus merilis antarmuka.

Mengembalikan nilai

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode Deskripsi
S_OK
 Metode berhasil.
E_INVALIDARG
 Argumen pointer NULL.
MF_E_MULTIPLE_SUBSCRIBERS
 Ada permintaan yang tertunda.
MF_E_NO_EVENTS_AVAILABLE
 Tidak ada peristiwa dalam antrean.
MF_E_SHUTDOWN
 Objek dimatikan.

Keterangan

Metode ini dijalankan secara sinkron.

Jika antrean sudah berisi peristiwa, metode akan segera mengembalikan S_OK. Jika antrean tidak berisi peristiwa, perilaku tergantung pada nilai dwFlags:

  • Jika dwFlags adalah 0, metode memblokir tanpa batas waktu sampai peristiwa baru diantrekan, atau sampai generator peristiwa dimatikan.
  • Jika dwFlags MF_EVENT_FLAG_NO_WAIT, metode gagal segera dengan kode pengembalian MF_E_NO_EVENTS_AVAILABLE.
Metode ini mengembalikan MF_E_MULTIPLE_SUBSCRIBERS jika sebelumnya Anda memanggil IMFMediaEventGenerator::BeginGetEvent dan belum memanggil IMFMediaEventGenerator::EndGetEvent.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung Windows Server 2008 [aplikasi desktop | Aplikasi UWP]
Target Platform Windows
Header mfobjects.h (termasuk Mfidl.h)
Pustaka Mfuuid.lib

Lihat juga

IMFMediaEventGenerator

Generator Peristiwa Media