METODE IMFMediaEventQueue::QueueEventParamVar (mfobjects.h)

Membuat peristiwa, menetapkan PROPVARIANT sebagai data peristiwa, dan menempatkan peristiwa dalam antrean.

Panggil metode ini di dalam implementasi IMFMediaEventGenerator::QueueEvent Anda. Teruskan parameter dari metode tersebut langsung ke metode ini.

Anda juga dapat memanggil metode ini ketika komponen Anda perlu menaikkan peristiwa yang tidak berisi atribut. Jika data peristiwa adalah penunjuk IUnknown , Anda dapat menggunakan IMFMediaEventQueue::QueueEventParamUnk. Jika peristiwa berisi atribut, gunakan IMFMediaEventQueue::QueueEvent sebagai gantinya.

Sintaks

HRESULT QueueEventParamVar(
  [in] MediaEventType    met,
  [in] REFGUID           guidExtendedType,
  [in] HRESULT           hrStatus,
  [in] const PROPVARIANT *pvValue
);

Parameter

[in] met

Menentukan jenis peristiwa yang akan ditambahkan ke antrean. Jenis peristiwa dikembalikan oleh metode IMFMediaEvent::GetType peristiwa. Untuk daftar jenis peristiwa, lihat Peristiwa Media Foundation.

[in] guidExtendedType

Jenis acara yang diperluas. Jika peristiwa tidak memiliki jenis yang diperluas, gunakan nilai GUID_NULL. Jenis yang diperluas dikembalikan oleh metode IMFMediaEvent::GetExtendedType peristiwa.

[in] hrStatus

Kode keberhasilan atau kegagalan yang menunjukkan status peristiwa. Nilai ini dikembalikan oleh metode IMFMediaEvent::GetStatus peristiwa.

[in] pvValue

Penunjuk ke PROPVARIANT yang berisi nilai peristiwa. Parameter ini bisa NULL. Nilai ini dikembalikan oleh metode IMFMediaEvent::GetValue peristiwa.

Nilai kembali

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

Menampilkan kode Deskripsi
S_OK
Metode berhasil.
MF_E_SHUTDOWN
Metode Matikan dipanggil.

Keterangan

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

  • Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
  • Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

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

IMFMediaEventQueue