ExFreePoolWithTag, fonction (wdm.h)
La routine ExFreePoolWithTag libère 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é 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é alloué à l’origine.
La balise est un littéral de caractères non nul de 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
None
Remarques
Les appelants d’ExFreePoolWithTag doivent s’exécuter sur IRQL <= DISPATCH_LEVEL. Un appelant à DISPATCH_LEVEL doit avoir spécifié un poolTypeXxxnon paginé lorsque la mémoire a été allouée. Sinon, l’appelant doit s’exécuter sur IRQL <= APC_LEVEL.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible à partir de Windows 2000. |
| Plateforme cible | Universal |
| 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 Notes) |
| Règles de conformité DDI | IrqlExFree1(wdm), IrqlExFree2(wdm), IrqlExFree3(wdm) |