Condividi tramite


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. Di conseguenza, le relative definizioni sono identiche.

Syntax

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

Members

Set

Specifica un GUID che identifica un set di eventi di streaming del kernel.

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

Id

Specifica il membro del set di eventi.

Flags

Specifica il tipo di richiesta.

Questo flag deve essere uno dei valori elencati nella tabella seguente.

Value Description
KSEVENT_TYPE_ENABLE Abilita la notifica degli eventi per questo tipo di evento. Il driver continua la notifica degli eventi fino a quando il client non lo disabilita in modo esplicito.
KSEVENT_TYPE_ONESHOT Abilita la notifica degli eventi solo per l'occorrenza successiva di questo evento. Il client non deve (e non deve) disabilitare l'evento dopo che si è verificato.
KSEVENT_TYPE_SETSUPPORT Query per l'elenco di set di eventi o per il supporto di un determinato set di eventi.
KSEVENT_TYPE_BASICSUPPORT Query per il supporto di un particolare tipo di evento.
KSEVENT_TYPE_ENABLEBUFFERED Invece di inviare una notifica al client, il driver accoda le notifiche degli eventi. 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. Non impostare questo flag autonomamente; In alternativa, OR con altri flag di questo elenco.
KSEVENT_TYPE_QUERYBUFFER Recupera la notifica dell'evento memorizzata nel buffer successivo.

Remarks

Microsoft fornisce diversi GUID del set di eventi definiti dal sistema. 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.

Per altre informazioni sugli eventi di streaming del kernel, vedere proprietà, eventi e metodi KS.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY