Funzione MmMapMdl (wdm.h)

Articolo
02/29/2024

Questa funzione esegue il mapping delle pagine fisiche descritte da un elenco di descrittori di memoria (MDL) nello spazio indirizzi virtuale 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 MDL valido.

[in] Protection

Bit per bit di flag 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 non è stato possibile richiamare la funzione di callback.

Commenti

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10, versione 1709
Server minimo supportato	Windows Server 2016
Piattaforma di destinazione	Windows
Intestazione	wdm.h
Libreria	NtosKrnl.lib
DLL	NtosKrnl.exe (modalità kernel)
IRQL	<=DISPATCH_LEVEL

Vedi anche

MM_MDL_ROUTINE

Condividi tramite