ExFreePoolWithTag, fonction (wdm.h)

  • Article

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)

Voir aussi

ExAllocatePoolWithQuotaTag

ExAllocatePoolWithTag

ExFreePool