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.
Osservazioni
Utilizzare MmUnmapLockedPages per rimuovere 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 dei bug. Per questo motivo, i driver devono usare MmMapLockedPagesSpecifyCache, se disponibile. Tale routine restituisce NULL in caso di errore, anziché causare un controllo dei bug. Se AccessMode è UserMode e non è possibile eseguire il mapping delle pagine specificate, 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.