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) |