KSEVENT-Struktur

Artikel
02/12/2024

Die KSEVENT-Struktur gibt ein einzelnes Kernelstreamingereignis innerhalb eines Kernelstreamingereignissatzes an.

Die Strukturen KSEVENT, KSMETHOD und KSPROPERTY sind Aliase für die KSIDENTIFIER-Struktur . Daher sind ihre Definitionen identisch.

Syntax

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

Member

Set

Gibt eine GUID an, die einen Kernelstreamingereignissatz identifiziert.

Weitere Informationen zu Ereignissatz-GUIDs finden Sie weiter unten im Abschnitt Hinweise .

Id

Gibt das Element des Ereignissatzes an.

Flags

Gibt den Anforderungstyp an.

Dieses Flag sollte einer der in der folgenden Tabelle aufgeführten Werte sein.

Wert	BESCHREIBUNG
KSEVENT_TYPE_ENABLE	Aktiviert die Ereignisbenachrichtigung für diesen Ereignistyp. Der Treiber setzt die Ereignisbenachrichtigung fort, bis sie vom Client explizit deaktiviert wird.
KSEVENT_TYPE_ONESHOT	Aktiviert die Ereignisbenachrichtigung nur für das nächste Auftreten dieses Ereignisses. Der Client muss (und sollte) das Ereignis nicht deaktivieren, sobald es aufgetreten ist.
KSEVENT_TYPE_SETSUPPORT	Abfragen nach der Liste der Ereignissätze oder zur Unterstützung eines bestimmten Ereignissatzes.
KSEVENT_TYPE_BASICSUPPORT	Abfragen zur Unterstützung eines bestimmten Ereignistyps.
KSEVENT_TYPE_ENABLEBUFFERED	Anstatt den Client zu benachrichtigen, stellt der Treiber Ereignisbenachrichtigungen in die Warteschlange. Der Client stellt dann eine zweite IOCTL_KS_ENABLE_EVENT Anforderung mit dem KSEVENT_TYPE_QUERYBUFFER aus, um die Ereignisbenachrichtigungen in die Warteschlange zu empfangen.
KSEVENT_TYPE_TOPOLOGY	Gibt an, dass das übergebene Ereignis vom Typ KSE_NODE ist, wobei NodeId die numerische ID des Topologieknotens angibt. Legen Sie dieses Flag nicht selbst fest. stattdessen ODER mit anderen Flags aus dieser Liste.
KSEVENT_TYPE_QUERYBUFFER	Ruft die nächste gepufferte Ereignisbenachrichtigung ab.

Hinweise

Microsoft stellt mehrere systemdefinierte Ereignissatz-GUIDs bereit. Minidriver geben eine dieser GUIDs im Element Festlegen an. Kernelstreamingereignissätze beginnen in der Regel mit einem Präfix KSEVENTSETID . Kernelstreamingereignissätze werden in ks.h, ksmedia.h, bdamedia.h und möglicherweise anderen Headerdateien definiert.

Weitere Informationen zu Kernelstreamingereignissen finden Sie unter KS-Eigenschaften, Ereignisse und Methoden.