Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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. Daher sind ihre Definitionen identisch.
Syntax
struct KSEVENT {
GUID Set;
ULONG Id;
ULONG Flags;
};
Members
Set
Gibt eine GUID an, die einen Kernel-Streamingereignissatz identifiziert.
For more information about event set GUIDs, see the Remarks section below.
Id
Gibt das Element des Ereignissatzes an.
Flags
Gibt den Anforderungstyp an.
Dieses Kennzeichen sollte einer der Werte sein, die in der folgenden Tabelle aufgeführt sind.
| Value | Description |
|---|---|
| KSEVENT_TYPE_ENABLE | Aktiviert die Ereignisbenachrichtigung für diesen Ereignistyp. Der Treiber setzt die Ereignisbenachrichtigung fort, bis der Client sie explizit deaktiviert. |
| KSEVENT_TYPE_ONESHOT | Aktiviert die Ereignisbenachrichtigung nur für das nächste Vorkommen dieses Ereignisses. Der Client muss das Ereignis nach dem Auftreten nicht deaktivieren (und sollte es nicht). |
| KSEVENT_TYPE_SETSUPPORT | Fragt nach der Liste der Ereignissätze oder zur Unterstützung eines bestimmten Ereignissatzes ab. |
| KSEVENT_TYPE_BASICSUPPORT | Abfragen zur Unterstützung eines bestimmten Ereignistyps. |
| KSEVENT_TYPE_ENABLEBUFFERED | Statt den Client zu benachrichtigen, werden ereignisbenachrichtigungen vom Treiber in die Warteschlange gestellt. 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. Legen Sie diese Kennzeichnung nicht selbst fest; Stattdessen OR it with other flags from this list. |
| KSEVENT_TYPE_QUERYBUFFER | Ruft die nächste gepufferte Ereignisbenachrichtigung ab. |
Remarks
Microsoft stellt mehrere systemdefinierte Ereignissatz-GUIDs bereit. 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.
Weitere Informationen zu Kernelstreamingereignissen finden Sie unter KS-Eigenschaften, Ereignisse und Methoden.
Requirements
Header: ks.h (include Ks.h)