Struktur KSEVENT

Artikel
02/07/2024

Struktur KSEVENT menentukan satu peristiwa streaming kernel dalam set peristiwa streaming kernel.

Struktur KSEVENT, KSMETHOD, dan KSPROPERTY adalah alias untuk struktur KSIDENTIFIER . Dengan demikian, definisinya identik.

Sintaks

struct KSEVENT {
  GUID Set;
  ULONG Id;
  ULONG Flags;
};

Anggota

Set

Menentukan GUID yang mengidentifikasi set peristiwa streaming kernel.

Untuk informasi selengkapnya tentang GUID set peristiwa, lihat bagian Keterangan di bawah ini.

Id

Menentukan anggota set peristiwa.

Flags

Menentukan jenis permintaan.

Bendera ini harus menjadi salah satu nilai yang tercantum dalam tabel berikut.

Nilai	Deskripsi
KSEVENT_TYPE_ENABLE	Mengaktifkan pemberitahuan kejadian untuk jenis kejadian ini. Driver melanjutkan pemberitahuan peristiwa hingga klien secara eksplisit menonaktifkannya.
KSEVENT_TYPE_ONESHOT	Mengaktifkan pemberitahuan peristiwa hanya untuk kejadian berikutnya dari kejadian ini. Klien tidak perlu (dan tidak boleh) menonaktifkan peristiwa setelah terjadi.
KSEVENT_TYPE_SETSUPPORT	Kueri untuk daftar set peristiwa, atau untuk dukungan set peristiwa tertentu.
KSEVENT_TYPE_BASICSUPPORT	Kueri untuk dukungan jenis peristiwa tertentu.
KSEVENT_TYPE_ENABLEBUFFERED	Alih-alih memberi tahu klien, driver mengantre pemberitahuan peristiwa. Klien kemudian mengeluarkan permintaan IOCTL_KS_ENABLE_EVENT kedua dengan KSEVENT_TYPE_QUERYBUFFER untuk menerima pemberitahuan peristiwa yang diantrekan.
KSEVENT_TYPE_TOPOLOGY	Menunjukkan bahwa peristiwa yang diteruskan berjenis KSE_NODE, di mana NodeId menunjukkan ID numerik simpul topologi. Jangan atur bendera ini sendiri; sebagai gantinya, ATAU dengan bendera lain dari daftar ini.
KSEVENT_TYPE_QUERYBUFFER	Mengambil pemberitahuan peristiwa buffer berikutnya.

Keterangan

Microsoft menyediakan beberapa GUID set peristiwa yang ditentukan sistem. Minidriver menentukan salah satu GUID ini di anggota Set . Set peristiwa streaming kernel biasanya dimulai dengan awalan KSEVENTSETID . Set peristiwa streaming kernel didefinisikan dalam ks.h, ksmedia.h, bdamedia.h, dan mungkin file header lainnya.

Untuk informasi selengkapnya tentang peristiwa streaming kernel, lihat Properti KS, Peristiwa, dan Metode.