Funzione MmMapMdl (wdm.h)

Articolo
02/07/2025

Questa funzione esegue il mapping delle pagine fisiche descritte da un elenco di descrittori di memoria (MDL) nello spazio degli indirizzi virtuali di sistema.

Sintassi

NTSTATUS MmMapMdl(
  [in] PMDL            MemoryDescriptorList,
  [in] ULONG           Protection,
  [in] PMM_MDL_ROUTINE DriverRoutine,
  [in] PVOID           DriverContext
);

Parametri

[in] MemoryDescriptorList

Puntatore a un file MDL valido.

[in] Protection

Flag bit per bit che indica la protezione da impostare per le pagine. I valori possibili sono PAGE_Xxx costanti definite in Wdm.h.

[in] DriverRoutine

Puntatore a una routine di callback fornita dal driver (MM_MDL_ROUTINE) richiamata dopo il mapping del file MDL.

[in] DriverContext

Puntatore a un contesto definito dal driver. La funzione di callback del driver può archiviare tutte le informazioni sullo stato nel contesto del driver e quindi esaminare il valore, quando viene richiamato il callback.

Valore restituito

Se è stata richiamata la funzione di callback a cui punta DriverRoutine, questa funzione restituisce STATUS_SUCCESS. La funzione restituisce un valore NTSTATUS appropriato se non è stato possibile eseguire il mapping di MDL o se non è stato possibile richiamare la funzione di callback.

Osservazioni

MmMapMdl esegue il mapping del file MDL (se non è già mappato), richiama il callback, rilascia il mapping (se ne è stato creato uno). Il chiamante non deve eseguire alcuna pulizia.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 10, versione 1709
server minimo supportato	Windows Server 2016
piattaforma di destinazione	Finestre
intestazione	wdm.h
libreria	NtosKrnl.lib
dll	NtosKrnl.exe (modalità kernel)
IRQL	<=DISPATCH_LEVEL

Vedere anche

MM_MDL_ROUTINE

Condividi tramite