KsGenerateEventList, fonction (ks.h)

Article
02/29/2024

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.