Macro MmGetSystemAddressForMdl (wdm.h)

La routine MmGetSystemAddressForMdl è obsoleta. Usare invece MmGetSystemAddressForMdlSafe .

MmGetSystemAddressForMdl è una macro che restituisce un indirizzo virtuale dello spazio di sistema non di pagina per il buffer descritto da MDL. Esegue il mapping delle pagine fisiche descritte da un determinato MDL nello spazio di sistema, se non sono già mappate allo spazio di sistema.

Sintassi

PVOID MmGetSystemAddressForMdl(
   MDL
);

Parametri

[in] MDL

Puntatore a un buffer il cui indirizzo virtuale di base corrispondente deve essere mappato.

Valore restituito

nessuno

Osservazioni

MmGetSystemAddressForMdl restituisce l'indirizzo virtuale dello spazio di sistema di base che esegue il mapping delle pagine fisiche descritte dall'MDL specificato.

I driver dei dispositivi PIO chiamano questa routine per tradurre un intervallo di indirizzi virtuali, descritto da MDL in Irp-MdlAddress>, per un buffer utente in un intervallo di indirizzi dello spazio di sistema.

MDL deve descrivere memoria non modificabile. In altre parole, l'input MDL deve descrivere un buffer di spazio utente già bloccato restituito da MmProbeAndLockPages, un buffer bloccato restituito da MmBuildMdlForNonPagedPool o memoria dello spazio di sistema allocata da pool non con pagine, memoria contigua o memoria non memorizzata nella cache.

L'indirizzo di base restituito ha lo stesso offset dell'indirizzo virtuale in MDL.

La finestra genera un bug per verificare se il tentativo di eseguire il mapping dello spazio di sistema ha esito negativo. Pertanto, è consigliabile usare MmGetSystemAddressForMdlSafe .

Requisiti

Requisito	Valore
Client minimo supportato	Obsoleta. Usare invece MmGetSystemAddressForMdlSafe.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL	IRQL <= DISPATCH_LEVEL

Vedi anche

MmBuildMdlForNonPagedPool

MmGetSystemAddressForMdlSafe

MmProbeAndLockPages