MmAllocateNonCachedMemory-Funktion (ntddk.h)

Artikel
02/29/2024

Die MmAllocateNonCachedMemory-Routine weist einen virtuellen Adressbereich aus nicht zwischengespeichertem und cacheorientiertem Arbeitsspeicher zu.

Syntax

PVOID MmAllocateNonCachedMemory(
  [in] SIZE_T NumberOfBytes
);

Parameter

[in] NumberOfBytes

Gibt die Größe des zu zuweisenden Bereichs in Bytes an.

Rückgabewert

Wenn der angeforderte Arbeitsspeicher nicht zugeordnet werden kann, ist der Rückgabewert NULL. Andernfalls handelt es sich um die virtuelle Basisadresse des zugeordneten Bereichs.

Hinweise

MmAllocateNonCachedMemory kann aus einer DriverEntry-Routine aufgerufen werden, um einen nicht zwischengespeicherten Block des virtuellen Arbeitsspeichers für verschiedene gerätespezifische Puffer zuzuweisen. Die Funktion gibt unabhängig von der angeforderten Zuordnungsgröße immer ein vollständiges Vielfaches der Seitengröße des virtuellen Speichers des nicht ausgelagerten Systemadressspeichers zurück.

Nicht zwischengespeicherte Zuordnungen werden auf ein integrales Vielfaches der Datencachezeilengröße des Prozessors ausgerichtet, um Cache- und Kohenzprobleme zu vermeiden.

Die seiten des physischen Arbeitsspeichers, die MmAllocateNonCachedMemory zurückgibt, sind in der Regel keine zusammenhängenden Seiten.

Der von MmAllocateNonCachedMemory zugewiesene Arbeitsspeicher ist nicht initialisiert. Ein Kernelmodustreiber muss diesen Arbeitsspeicher zuerst null, wenn er für Software im Benutzermodus sichtbar macht (um zu vermeiden, dass potenziell privilegierte Inhalte verloren gehen).

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	ntddk.h (include Ntddk.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<=APC_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), IrqlMmApcLte(wdm), SpNoWait(storport), StorPortStartIo(storport)