Funzione MmMapLockedPages (wdm.h)
La routine MmMapLockedPages è obsoleta per Windows 2000 e versioni successive di Windows e per Windows Me. È supportato solo per i driver WDM che devono essere eseguiti in Windows 98. In caso contrario, usare MmMapLockedPagesSpecifyCache.
La routine MmMapLockedPages esegue il mapping delle pagine fisiche descritte da un determinato MDL.
Sintassi
PVOID MmMapLockedPages(
[in] PMDL MemoryDescriptorList,
[in] __drv_strictType(KPROCESSOR_MODE / enum _MODE,__drv_typeConst)KPROCESSOR_MODE AccessMode
);
Parametri
[in] MemoryDescriptorList
Puntatore a un MDL aggiornato da MmProbeAndLockPages.
[in] AccessMode
Specifica la modalità di accesso in cui eseguire il mapping del file MDL, KernelMode o UserMode. Quasi tutti i driver devono usare KernelMode.
Valore restituito
MmMapLockedPages restituisce l'indirizzo iniziale delle pagine mappate. Per i sistemi operativi basati su NT prima di Windows NT 4.0 Service Pack 4 (SP4), MmMapLockedPages restituisce l'indirizzo iniziale della prima pagina delle pagine mappate.
Commenti
Utilizzare MmUnmapLockedPages per annullare il mapping delle pagine fisiche mappate da MmMapLockedPages.
Se AccessMode è KernelMode e MmMapLockedPages non è in grado di eseguire il mapping delle pagine specificate, il sistema genera un controllo di bug. Per questo motivo, i driver devono usare MmMapLockedPagesSpecifyCache quando disponibile. Tale routine restituisce NULL in caso di errore, anziché causare un controllo di bug. Se AccessMode è UserMode e le pagine specificate non possono essere mappate, la routine genera un'eccezione. I chiamanti che specificano UserMode devono eseguire il wrapping della chiamata a MmMapLockedPages in un blocco try/except . Per altre informazioni, vedere Gestione delle eccezioni.
I chiamanti di MmMapLockedPages devono essere in esecuzione in IRQL <= DISPATCH_LEVEL se AccessMode è KernelMode. In caso contrario, il chiamante deve essere in esecuzione in IRQL <= APC_LEVEL.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Obsoleto per Windows 2000 e versioni successive di Windows e per Windows Me. Questa routine è supportata solo per i driver WDM che devono essere eseguiti in Windows 98. In caso contrario, usare MmMapLockedPagesSpecifyCache. |
| Piattaforma di destinazione | Universale |
| Intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | Vedere la sezione Osservazioni. |
| Regole di conformità DDI | HwStorPortProhibitedDDIs(storport) |