IMFMediaEventGenerator::Metode GetEvent (mfobjects.h)

Artikel
03/04/2024

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

Bagikan melalui