Freigeben über


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, mit dem der Puffer identifiziert 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 an den Anfang des reservierten Speicherpuffers zurück.

Bemerkungen

MmAllocateMappingAddress reserviert einen virtuellen Systemadressbereich für den zu verwendenden Anrufer. Es wird kein physischer Speicher für den virtuellen Adressbereich zugewiesen, und auf den virtuellen Speicher kann erst zugegriffen werden, wenn er von der MmMapLockedPagesWithReservedMapping Routine zugeordnet wird. Der Aufrufer hebt die Zuordnung des reservierten Speicherbereichs auf, indem die MmUnmapReservedMapping Routine aufgerufen wird. Schließlich kann der Anrufer den reservierten Bereich freigeben, indem er MmFreeMappingAddressaufruft.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Verfügbar in Windows XP und höheren Versionen von Windows.
Zielplattform- Universal
Header- wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Library NtosKrnl.lib
DLL- NtosKrnl.exe
IRQL- <=APC_LEVEL

Siehe auch

MmFreeMappingAddress

MmMapLockedPagesWithReservedMapping

MmUnmapReservedMapping