KSEVENT structure

The KSEVENT structure specifies a single kernel streaming event within a kernel streaming event set.

The KSEVENT, KSMETHOD, and KSPROPERTY structures are aliases for the KSIDENTIFIER structure. Dengan demikian, definisi mereka identik.

Syntax

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

Members

Set

Menentukan GUID yang mengidentifikasi set peristiwa streaming kernel.

For more information about event set GUIDs, see the Remarks section below.

Id

Menentukan anggota set peristiwa.

Flags

Menentukan jenis permintaan.

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

Value	Description
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 peristiwa ini. Klien tidak perlu (dan tidak boleh) menonaktifkan peristiwa setelah terjadi.
KSEVENT_TYPE_SETSUPPORT	Kueri untuk daftar set peristiwa, atau untuk dukungan kumpulan peristiwa tertentu.
KSEVENT_TYPE_BASICSUPPORT	Kueri untuk dukungan jenis peristiwa tertentu.
KSEVENT_TYPE_ENABLEBUFFERED	Alih-alih memberi tahu klien, driver mengantre pemberitahuan peristiwa. The client then issues a second IOCTL_KS_ENABLE_EVENT request with the KSEVENT_TYPE_QUERYBUFFER to receive the queued event notifications.
KSEVENT_TYPE_TOPOLOGY	Indicates that the event passed is of type KSE_NODE, where NodeId indicates the numeric ID of the topology node. Jangan atur bendera ini sendiri; sebagai gantinya, ATAU dengan bendera lain dari daftar ini.
KSEVENT_TYPE_QUERYBUFFER	Mengambil pemberitahuan peristiwa buffer berikutnya.

Remarks

Microsoft menyediakan beberapa GUID set peristiwa yang ditentukan sistem. Minidrivers specify one of these GUIDs in the Set member. Kernel streaming event sets typically begin with a KSEVENTSETID prefix. Kernel streaming event sets are defined in ks.h, ksmedia.h, bdamedia.h, and possibly other header files.

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

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY