Structure KSEVENT

Article
06/15/2023

La structure KSEVENT spécifie un événement de streaming de noyau unique au sein d’un jeu d’événements de diffusion en continu du noyau.

Les structures KSEVENT, KSMETHOD et KSPROPERTY sont des alias pour la structure KSIDENTIFIER . Par conséquent, leurs définitions sont identiques.

Syntaxe

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

Membres

Set

Spécifie un GUID qui identifie un jeu d’événements de diffusion en continu du noyau.

Pour plus d’informations sur les GUID de jeu d’événements, consultez la section Remarques ci-dessous.

Id

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

Flags

Spécifie le type de demande.

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

Valeur	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 la 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 de notifier le client, le pilote met en file d’attente les notifications d’événements. Le client émet ensuite une deuxième demande IOCTL_KS_ENABLE_EVENT avec le KSEVENT_TYPE_QUERYBUFFER pour recevoir les notifications d’événements mis en file d’attente.
KSEVENT_TYPE_TOPOLOGY	Indique que l’événement passé est de type KSE_NODE, où NodeId indique l’ID numérique du nœud de topologie. Ne définissez pas cet indicateur seul ; à la place, OU avec d’autres indicateurs de cette liste.
KSEVENT_TYPE_QUERYBUFFER	Récupère la notification d’événement mis en mémoire tampon suivante.

Remarques

Microsoft fournit plusieurs GUID de jeu d’événements définis par le système. Les minidrivers spécifient l’un de ces GUID dans le membre Set . Les jeux d’événements de diffusion en continu du noyau commencent généralement par un préfixe KSEVENTSETID . Les jeux d’événements de diffusion en continu du noyau sont définis dans ks.h, ksmedia.h, bdamedia.h et éventuellement d’autres fichiers d’en-tête.

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