Funzione MmMapLockedPages (wdm.h)

  • Articolo

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)

Vedi anche

MmGetSystemAddressForMdl

MmGetSystemAddressForMdlSafe

MmMapLockedPagesSpecifyCache

MmProbeAndLockPages

MmUnmapLockedPages