ExFreePoolWithTag-Funktion (wdm.h)
Mit dem ExFreePoolWithTag Routine wird ein Poolspeicherblock 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 ExAllocatePoolWithQuotaTagzugewiesen wird.
[in] Tag
Gibt den Tagwert an, der an ExAllocatePoolWithTag oder ExAllocatePoolWithQuota Tag übergeben wird, wenn der Speicherblock ursprünglich zugewiesen wurde.
Das Tag ist ein Nicht-Null-Zeichenliteral von ein bis vier Zeichen, das durch einfache Anführungszeichen (z. B. "Tag1") getrennt ist. Die Zeichenfolge wird in der Regel in umgekehrter Reihenfolge angegeben (z. B. "1gaT"). Jedes ASCII-Zeichen im Tag muss ein Wert im Bereich 0x20 (Leerzeichen) sein, um 0x7E (Tilde) zu 0x7E. Jeder Zuordnungscodepfad sollte ein eindeutiges Pooltag verwenden, um Debuggern und Prüfern bei der Identifizierung des Codepfads zu helfen.
Rückgabewert
Nichts
Bemerkungen
Aufrufer von ExFreePoolWithTag- müssen unter IRQL-<= DISPATCH_LEVEL ausgeführt werden. Ein Aufrufer bei DISPATCH_LEVEL muss ein NonPaged-Xxx-PoolType- angegeben haben, wenn der Speicher zugewiesen wurde. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Ab Windows 2000 verfügbar. |
| Zielplattform- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= DISPATCH_LEVEL (siehe Abschnitt "Hinweise") |
| DDI-Complianceregeln | IrqlExFree1(wdm), IrqlExFree2(wdm), IrqlExFree3(wdm) |