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. Proto jsou jejich definice identické.

Syntax

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

Members

Set

Určuje identifikátor GUID, který identifikuje sadu událostí streamování jádra.

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

Id

Určuje člena sady událostí.

Flags

Určuje typ požadavku.

Tento příznak by měl být jednou z hodnot uvedených v následující tabulce.

Value Description
KSEVENT_TYPE_ENABLE Povolí oznámení události pro tento typ události. Ovladač pokračuje v oznámení událostí, dokud ho klient explicitně nezakáže.
KSEVENT_TYPE_ONESHOT Povolí oznámení události pouze pro další výskyt této události. Klient nemusí (a neměl by) zakázat událost, jakmile k ní dojde.
KSEVENT_TYPE_SETSUPPORT Dotazy na seznam sad událostí nebo pro podporu konkrétní sady událostí.
KSEVENT_TYPE_BASICSUPPORT Dotazy na podporu konkrétního typu události
KSEVENT_TYPE_ENABLEBUFFERED Místo upozorňování klienta ovladač zařadí oznámení událostí do fronty. 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. Nenastavujte tento příznak samostatně; místo toho NEBO s jinými příznaky z tohoto seznamu.
KSEVENT_TYPE_QUERYBUFFER Načte další oznámení události s vyrovnávací pamětí.

Remarks

Microsoft poskytuje několik identifikátorů GUID sady událostí definovaných systémem. 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.

Další informace oudálostch

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY