KsFreeEventList, fonction (ks.h)

Article
02/26/2024

La fonction KsFreeEventList gère la libération de tous les événements d’une liste spécifiée, en supposant que ces événements sont composés de structures KSEVENT_ENTRY . Cette fonction ne peut être appelée qu’à PASSIVE_LEVEL.

Syntaxe

KSDDKAPI VOID KsFreeEventList(
  [in]      PFILE_OBJECT      FileObject,
  [in, out] PLIST_ENTRY       EventsList,
  [in]      KSEVENTS_LOCKTYPE EventsFlags,
  [in]      PVOID             EventsLock
);

Paramètres

[in] FileObject

Spécifie l’objet de fichier passé à la fonction de suppression pour les informations de contexte. L’objet de fichier associé est utilisé pour effectuer une comparaison avec l’objet de fichier spécifié à l’origine lors de l’activation de l’événement. Cela permet d’utiliser une liste d’événements unique pour plusieurs clients différenciés par des objets de fichier.

[in, out] EventsList

Pointe vers le début de la liste des éléments KSEVENT_ENTRY à libérer. Si des événements de la liste sont actuellement désactivés, ils sont transférés. Si de nouveaux éléments sont ajoutés à la liste pendant son traitement, il se peut qu’ils ne soient pas libérés.

[in] EventsFlags

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

[in] EventsLock

Utilisé pour synchroniser l’accès à un élément de la liste. Une fois l’élément accédé, il est marqué comme étant en cours de suppression, de sorte que les demandes de suppression suivantes échouent. Le verrou est ensuite libéré après l’appel de la fonction de suppression, le cas échéant. La fonction de suppression doit se synchroniser avec la génération d’événements avant de supprimer l’élément de la liste.

Valeur de retour

None

Remarques

La fonction KsFreeEventList appelle le gestionnaire de suppression, puis elle appelle KsDiscardEvent pour chaque événement. Il ne suppose pas que l’appelant est le propriétaire de l’événement.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib

Voir aussi

KsDiscardEvent

Partager via