ExFreePoolWithTag-Funktion (wdm.h)

Mit der ExFreePoolWithTag-Routine wird ein Block des Poolspeichers zugeordnet, der dem angegebenen Tag zugeordnet ist.

Syntax

void ExFreePoolWithTag(
  [in] PVOID P,
  [in] ULONG Tag
);

Parameter

[in] P

Gibt die Anfangsadresse eines Poolsspeicherblocks an, der entweder von ExAllocatePoolWithTag oder ExAllocatePoolWithQuotaTag zugewiesen wird.

[in] Tag

Gibt den Tagwert an, der an ExAllocatePoolWithTag oder ExAllocatePoolWithQuotaTag übergeben wurde, wenn der Speicherblock ursprünglich zugewiesen wurde.

Das Tag ist ein zeichenfreies Literal von 1 bis vier Zeichen, das durch einzelne Anführungszeichen getrennt ist (z. B. "Tag1"). Die Zeichenfolge wird normalerweise in umgekehrter Reihenfolge angegeben (z. B. "1gaT"). Jedes ASCII-Zeichen im Tag muss ein Wert im Bereich 0x20 (Leerzeichen) bis 0x7E (Tilde) sein. Jeder Zuordnungscodepfad sollte ein eindeutiges Pooltag verwenden, um Debuggern und Prüfern beim Identifizieren des Codepfads zu helfen.

Rückgabewert

Keine

Bemerkungen

Aufrufer von ExFreePoolWithTag müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden. Ein Aufrufer bei DISPATCH_LEVEL muss einen NonPagedXxxPoolType angegeben haben, als der Arbeitsspeicher zugewiesen wurde. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar ab Windows 2000.
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= DISPATCH_LEVEL (siehe Abschnitt Hinweise)
DDI-Complianceregeln	IrqlExFree1(wdm), IrqlExFree2(wdm), IrqlExFree3(wdm)

Weitere Informationen

ExAllocatePoolWithQuotaTag

ExAllocatePoolWithTag

ExFreePool