Udostępnij przez


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. W związku z tym ich definicje są identyczne.

Syntax

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

Members

Set

Określa identyfikator GUID identyfikujący zestaw zdarzeń przesyłania strumieniowego jądra.

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

Id

Określa element członkowski zestawu zdarzeń.

Flags

Określa typ żądania.

Ta flaga powinna być jedną z wartości wymienionych w poniższej tabeli.

Value Description
KSEVENT_TYPE_ENABLE Włącza powiadomienie o zdarzeniu dla tego typu zdarzenia. Sterownik kontynuuje powiadomienie o zdarzeniach, dopóki klient jawnie go nie wyłączy.
KSEVENT_TYPE_ONESHOT Włącza powiadomienie o zdarzeniu tylko dla następnego wystąpienia tego zdarzenia. Klient nie musi (i nie powinien) wyłączyć zdarzenia po jego wystąpieniu.
KSEVENT_TYPE_SETSUPPORT Zapytania dotyczące listy zestawów zdarzeń lub obsługi określonego zestawu zdarzeń.
KSEVENT_TYPE_BASICSUPPORT Zapytania dotyczące obsługi określonego typu zdarzenia.
KSEVENT_TYPE_ENABLEBUFFERED Zamiast powiadamiać klienta, sterownik kolejkuje powiadomienia o zdarzeniach. 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. Nie ustawiaj tej flagi samodzielnie; zamiast tego lub z innymi flagami z tej listy.
KSEVENT_TYPE_QUERYBUFFER Pobiera następne buforowane powiadomienie o zdarzeniu.

Remarks

Firma Microsoft udostępnia kilka identyfikatorów GUID zestawu zdarzeń zdefiniowanych przez system. 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.

Aby uzyskać więcej informacji na temat zdarzeń przesyłania strumieniowego jądra, zobacz Właściwości ks, zdarzenia i metody.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY