KSEVENT-Struktur
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.
Anforderungen
Header: ks.h (include Ks.h)