Freigeben über


MmMapLockedPages-Funktion (wdm.h)

Die MmMapLockedPages-Routine ist für Windows 2000 und höhere Versionen von Windows und für Windows Me veraltet . Es wird nur für WDM-Treiber unterstützt, die unter Windows 98 ausgeführt werden müssen. Verwenden Sie andernfalls MmMapLockedPagesSpecifyCache.

Die MmMapLockedPages-Routine ordnet die physischen Seiten zu, die von einer bestimmten MDL beschrieben werden.

Syntax

PVOID MmMapLockedPages(
  [in] PMDL                                                                          MemoryDescriptorList,
  [in] __drv_strictType(KPROCESSOR_MODE / enum _MODE,__drv_typeConst)KPROCESSOR_MODE AccessMode
);

Parameter

[in] MemoryDescriptorList

Zeiger auf eine MDL, die von MmProbeAndLockPages aktualisiert wurde.

[in] AccessMode

Gibt den Zugriffsmodus an, in dem die MDL zugeordnet werden soll, entweder KernelMode oder UserMode. Fast alle Treiber sollten KernelMode verwenden.

Rückgabewert

MmMapLockedPages gibt die Startadresse der zugeordneten Seiten zurück. (Bei NT-basierten Betriebssystemen vor Windows NT 4.0 Service Pack 4 (SP4) gibt MmMapLockedPages die Anfangsadresse der ersten Seite der zugeordneten Seiten zurück.)

Hinweise

Verwenden Sie MmUnmapLockedPages , um die Zuordnung der physischen Seiten aufzuheben, die von MmMapLockedPages zugeordnet wurden.

Wenn AccessMode KernelMode ist und MmMapLockedPages die angegebenen Seiten nicht zuordnen kann, gibt das System eine Fehlerüberprüfung aus. (Aus diesem Grund sollten Treiber MmMapLockedPagesSpecifyCache verwenden, wenn verfügbar. Diese Routine gibt NULL bei Einem Fehler zurück, anstatt eine Fehlerprüfung zu verursachen.) Wenn AccessModeUserMode ist und die angegebenen Seiten nicht zugeordnet werden können, löst die Routine eine Ausnahme aus. Aufrufer, die UserMode angeben, müssen den Aufruf von MmMapLockedPages in einem try/except-Block umschließen. Weitere Informationen finden Sie unter Behandeln von Ausnahmen.

Aufrufer von MmMapLockedPages müssen unter IRQL <= DISPATCH_LEVEL ausgeführt werden, wenn AccessModeKernelMode ist. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Veraltet für Windows 2000 und höhere Versionen von Windows und für Windows Me. Diese Routine wird nur für WDM-Treiber unterstützt, die unter Windows 98 ausgeführt werden müssen. Verwenden Sie andernfalls MmMapLockedPagesSpecifyCache.
Zielplattform Universell
Header wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL Weitere Informationen finden Sie im Abschnitt mit den Hinweisen.
DDI-Complianceregeln HwStorPortProhibitedDDIs(storport)

Weitere Informationen

MmGetSystemAddressForMdl

MmGetSystemAddressForMdlSafe

MmMapLockedPagesSpecifyCache

MmProbeAndLockPages

MmUnmapLockedPages