MmAllocateMappingAddress-Funktion (wdm.h)
Die MmAllocateMappingAddress-Routine reserviert einen Bereich des virtuellen Systemadressraums der angegebenen Größe.
Syntax
PVOID MmAllocateMappingAddress(
[in] SIZE_T NumberOfBytes,
[in] ULONG PoolTag
);
Parameter
[in] NumberOfBytes
Gibt die Anzahl der zu reservierenden Bytes an.
[in] PoolTag
Gibt ein vierstelliges Tag an, das zum Identifizieren des Puffers verwendet wird. Verwenden Sie für jeden Zuordnungscodepfad ein eindeutiges PoolTag-Tag . Eine Beschreibung der Pooltags finden Sie unter ExAllocatePoolWithTag.
Rückgabewert
MmAllocateMappingAddress gibt einen Zeiger auf den Anfang des reservierten Speicherpuffers zurück.
Hinweise
MmAllocateMappingAddress reserviert einen virtuellen Systemadressbereich für den Aufrufer. Für den virtuellen Adressbereich wird kein physischer Arbeitsspeicher zugewiesen, und auf den virtuellen Arbeitsspeicher kann erst zugegriffen werden, wenn er von der MmMapLockedPagesWithReservedMapping-Routine zugeordnet wird. Der Aufrufer hebt die Zuordnung des reservierten Speicherbereichs auf, indem er die MmUnmapReservedMapping-Routine aufruft . Schließlich kann der Aufrufer den reservierten Bereich durch Aufrufen von MmFreeMappingAddress freigeben.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Verfügbar in Windows XP und höheren Versionen von Windows. |
Zielplattform | Universell |
Header | wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h) |
Bibliothek | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | <=APC_LEVEL |