ExAllocatePoolZero-Funktion (wdm.h)

Diese Routine ist ein Wrapper für und eine empfohlene Ersatzoption für ExAllocatePoolWithTag.

ExAllocatePoolZero weist den Poolspeicher des angegebenen Typs zu und gibt einen Zeiger auf den zugeordneten Block zurück. Er ist identisch mit ExAllocatePoolWithTag , aber null initialisiert den zugeordneten Arbeitsspeicher.

Syntax

PVOID ExAllocatePoolZero(
  __drv_strictTypeMatch(__drv_typeExpr)POOL_TYPE PoolType,
  SIZE_T                                         NumberOfBytes,
  ULONG                                          Tag
);

Parameter

PoolType

Der Typ des zuzuweisenden Poolspeichers. Eine Beschreibung der verfügbaren Poolspeichertypen finden Sie unter POOL_TYPE.

Sie können den Enumerationswert ändern, indem Sie einen bitweisen OR mit dem in wdm.hdefinierten POOL_RAISE_IF_ALLOCATION_FAILURE-Flag ausführen. Dieses Flag bewirkt, dass eine Ausnahme ausgelöst wird, wenn die Anforderung nicht erfüllt werden kann. Die Verwendung dieses Flags wird nicht empfohlen, da es teuer ist.

Auf ähnliche Weise können Sie den PoolType-Wert ändern, indem Sie bitweise diesen Wert mit dem POOL_COLD_ALLOCATION-Flag (auch definiert in wdm.h) als Hinweis an den Kernel ändern, um den Arbeitsspeicher aus Seiten zuzuweisen, die wahrscheinlich schnell ausgelagert werden. Um den Speicher des residenten Pools so weit wie möglich zu reduzieren, sollten Sie nicht häufig auf diese Zuordnungen verweisen. Das POOL_COLD_ALLOCATION-Flag ist nur ein Hinweis.

NumberOfBytes

Die Anzahl der zu belegenden Bytes.

Tag

Das Pooltag, das für den zugewiesenen Arbeitsspeicher verwendet werden soll. Geben Sie das Pooltag als Zeichenliteral ungleich 0 von 1 bis vier Zeichen an, Tag1die durch einzelne Anführungszeichen getrennt sind (z. B. ). 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

ExAllocatePoolZero gibt NULL zurück, wenn im freien Pool nicht genügend Arbeitsspeicher vorhanden ist, um die Anforderung zu erfüllen. Andernfalls gibt die Routine einen Zeiger auf den zugewiesenen Arbeitsspeicher zurück.

Hinweise

Diese Routine wird für die allgemeine Poolzuordnung von Arbeitsspeicher verwendet.

Um unter Windows-Versionen vor Windows 10 Version 2004 auszuführen, muss der Treiber POOL_ZERO_DOWN_LEVEL_SUPPORT definieren und ExInitializeDriverRuntime aufrufen, bevor diese Funktion aufgerufen wird.

Der einzige Unterschied zwischen dieser Funktion und ExAllocatePoolWithTag besteht darin, dass der Arbeitsspeicher null initialisiert ist. Wenn dies nicht gewünscht ist, verwenden Sie stattdessen ExAllocatePoolUninitialized , ein Wrapper für ExAllocatePoolWithTag.

Ein Treiber sollte nur auf den Arbeitsspeicher innerhalb des Bytebereichs zugreifen, den er ordnet. Der Zugriff auf Arbeitsspeicher außerhalb dieses Bereichs kann den Pool beschädigen und zum Absturz des Systems führen.

Weitere Anleitungen finden Sie im Abschnitt Hinweise von ExAllocatePoolWithTag .

Anforderungen

Weitere Informationen

ExAllocatePoolUninitialized