Partager via


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. Par conséquent, leurs définitions sont identiques.

Syntax

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

Members

Set

Spécifie un GUID qui identifie un jeu d’événements de streaming de noyau.

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

Id

Spécifie le membre du jeu d’événements.

Flags

Spécifie le type de requête.

Cet indicateur doit être l’une des valeurs répertoriées dans le tableau suivant.

Value Description
KSEVENT_TYPE_ENABLE Active la notification d’événement pour ce type d’événement. Le pilote continue la notification d’événement jusqu’à ce que le client le désactive explicitement.
KSEVENT_TYPE_ONESHOT Active la notification d’événement pour l’occurrence suivante de cet événement uniquement. Le client n’a pas besoin (et ne doit pas) désactiver l’événement une fois qu’il s’est produit.
KSEVENT_TYPE_SETSUPPORT Requêtes pour la liste des jeux d’événements ou pour la prise en charge d’un jeu d’événements particulier.
KSEVENT_TYPE_BASICSUPPORT Requêtes pour la prise en charge d’un type d’événement particulier.
KSEVENT_TYPE_ENABLEBUFFERED Au lieu d’avertir le client, le pilote met en file d’attente les notifications d’événements. 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. Ne définissez pas cet indicateur par lui-même ; au lieu de cela, OU avec d’autres indicateurs de cette liste.
KSEVENT_TYPE_QUERYBUFFER Récupère la notification d’événement mise en mémoire tampon suivante.

Remarks

Microsoft fournit plusieurs GUID de jeu d’événements définis par le système. 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.

Pour plus d’informations sur les événements de diffusion en continu du noyau, consultez propriétés, événements et méthodes KS.

Requirements

Header: ks.h (include Ks.h)

See also

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY