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. Si elle est présente, cette valeur est comparée à l’identificateur défini pour chaque événement de la liste. S’il n’est pas présent, les identificateurs de jeu sont ignorés et seul l’identificateur d’événement spécifique est utilisé dans la comparaison pour les é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 la tête de la liste des éléments KSEVENT_ENTRY sur lesquels l’événement est trouvé.
[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
Aucun
Remarques
Cette fonction peut être appelée à n’importe quel niveau IRQL si le mécanisme de verrouillage l’autorise.
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | N’importe quel niveau (voir la section Remarques) |