KsGenerateEventList, fonction (ks.h)

La fonction KsGenerateEventList énumère la liste des événements et recherche l’événement spécifié à générer.

Syntaxe

KSDDKAPI VOID KsGenerateEventList(
  [in, optional] GUID              *Set,
  [in]           ULONG             EventId,
  [in]           PLIST_ENTRY       EventsList,
  [in]           KSEVENTS_LOCKTYPE EventsFlags,
  [in]           PVOID             EventsLock
);

Paramètres

[in, optional] Set

Spécifie un jeu facultatif auquel appartient l’événement à générer. Si elle est présente, cette valeur est comparée à l’identificateur défini pour chaque événement de la liste. S’ils ne sont pas présents, les identificateurs de jeu sont ignorés et seul l’identificateur d’événement spécifique est utilisé dans la comparaison des événements correspondants dans la liste. Cette comparaison permet de gagner du temps lorsque tous les événements sont connus pour être contenus dans un même ensemble.

[in] EventId

Spécifie l’identificateur d’événement spécifique à rechercher dans la liste.

[in] EventsList

Pointe vers le début de la liste des éléments KSEVENT_ENTRY sur lesquels l’événement se trouve.

[in] EventsFlags

Spécifie l’indicateur KSEVENTS_LOCKTYPE spécifiant le type de verrou d’exclusion à utiliser pour accéder à la liste des événements. Si aucun indicateur n’est défini, aucun verrou n’est pris.

[in] EventsLock

Permet de synchroniser l’accès à un élément de la liste. Le verrou est pris avant l’énumération de la liste et libéré après l’énumération.

Valeur de retour

None

Remarques

Cette fonction peut être appelée à n’importe quel niveau IRQL si le mécanisme de verrouillage l’autorise.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	N’importe quel niveau (voir la section Remarques)

Voir aussi

KsFilterAddEvent

KsFilterGenerateEvents

KsPinAddEvent

KsPinGenerateEvents