MmMapLockedPages-Funktion (wdm.h)
Die MmMapLockedPages Routine ist veraltete für Windows 2000 und höhere Versionen von Windows und für Windows Me. Sie 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 MmProbeAndLockPagesaktualisiert 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 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.)
Bemerkungen
Verwenden Sie MmUnmapLockedPages-, um die Zuordnung der physischen Seiten aufzuheben, die von MmMapLockedPageszugeordnet 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- fehlerfehlern zurück, anstatt eine Fehlerüberprüfung zu verursachen.) Wenn AccessMode-UserMode- 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 an MmMapLockedPages in einem try/except Block umschließen. Weitere Informationen finden Sie unter Behandeln von Ausnahmen.
Aufrufer von MmMapLockedPages- müssen bei IRQL-<= DISPATCH_LEVEL ausgeführt werden, wenn AccessMode-KernelMode-ist. Andernfalls muss der Aufrufer unter IRQL <= APC_LEVEL ausgeführt werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte 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- | Universal |
| Header- | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | Siehe Abschnitt "Hinweise". |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport) |