FltReleaseContextsEx, fonction (fltkernel.h)
FltReleaseContextsEx libère chaque contexte dans une structure de FLT_RELATED_CONTEXTS_EX donnée.
Syntaxe
VOID FLTAPI FltReleaseContextsEx(
[in] SIZE_T ContextsSize,
[in] PFLT_RELATED_CONTEXTS_EX Contexts
);
Paramètres
[in] ContextsSize
Taille, en octets, de la structure FLT_RELATED_CONTEXTS_EX pointée par Contexts. Défini sur taille de(FLT_RELATED_CONTEXTS_EX).
[in] Contexts
Pointeur vers la structure FLT_RELATED_CONTEXTS_EX.
Valeur de retour
Aucun
Remarques
Pour plus d’informations sur les contextes, consultez À propos des contextes minifilter.
FltReleaseContextsEx décrémente le nombre de références sur tous les contextes de la structure FLT_RELATED_CONTEXTS_EX et définit tous les membres de la structure sur NULL_CONTEXT.
Pour obtenir la structure FLT_RELATED_CONTEXTS_EX pour un pilote minifilter donné pour une requête d’E/S donnée, appelez FltGetContextsEx.
Pour plus d’informations sur le comptage des références de contexte, consultez Contextes de référencement.
Les appelants de FltReleaseContextsEx doivent s’exécuter à l'<IRQL = DISPATCH_LEVEL si tous les contextes ont été alloués à partir d’un pool non paginé. Si des contextes ont été alloués à partir d’un pool paginé, les appelants doivent s’exécuter à l'<IRQL = APC_LEVEL.
Lorsque le nombre de références de chaque contexte atteint zéro, le contexte est libéré immédiatement si l’appelant s’exécute à IRQL <= APC_LEVEL. Si l’appelant s’exécute au DISPATCH_LEVEL IRQL, un élément de travail est planifié pour libérer le contexte.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 8. |
| plateforme cible | Universel |
| d’en-tête | fltkernel.h (include Fltkernel.h) |
| bibliothèque | FltMgr.lib |
| DLL | Fltmgr.sys |
| IRQL | Voir la section Remarques. |