Structure KSEVENT

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.

Configuration requise

En-tête : ks.h (include Ks.h)

Voir aussi

KSE_NODE

KSIDENTIFIER

KSMETHOD

KSPROPERTY