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) |