ExFreePoolWithTag, fonction (wdm.h)
La routine ExFreePoolWithTag désalloue un bloc de mémoire de pool alloué avec la balise spécifiée.
Syntaxe
void ExFreePoolWithTag(
[in] PVOID P,
[in] ULONG Tag
);
Paramètres
[in] P
Spécifie l’adresse de début d’un bloc de mémoire de pool allouée par ExAllocatePoolWithTag ou ExAllocatePoolWithQuotaTag.
[in] Tag
Spécifie la valeur de balise passée à ExAllocatePoolWithTag ou ExAllocatePoolWithQuotaTag lorsque le bloc de mémoire a été initialement alloué.
La balise est un littéral de caractère différent de zéro d’un à quatre caractères délimités par des guillemets simples (par exemple, « Tag1 »). La chaîne est généralement spécifiée dans l’ordre inverse (par exemple, « 1gaT »). Chaque caractère ASCII de la balise doit être une valeur dans la plage 0x20 (espace) à 0x7E (tilde). Chaque chemin de code d’allocation doit utiliser une balise de pool unique pour aider les débogueurs et les vérificateurs à identifier le chemin du code.
Valeur de retour
Aucun
Remarques
Les appelants de ExFreePoolWithTag doivent s’exécuter à l'<IRQL = DISPATCH_LEVEL. Un appelant à DISPATCH_LEVEL doit avoir spécifié un NonPagedXxxPoolType lorsque la mémoire a été allouée. Dans le cas contraire, l’appelant doit s’exécuter à l'<IRQL = APC_LEVEL.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Disponible à partir de Windows 2000. |
| plateforme cible | Universel |
| d’en-tête | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= DISPATCH_LEVEL (voir la section Remarques) |
| règles de conformité DDI | irqlExFree1(wdm), IrqlExFree2(wdm), IrqlExFree3(wdm) |