Funzione MmMapIoSpace (wdm.h)
La routine MmMapIoSpace esegue il mapping dell'intervallo di indirizzi fisici specificato allo spazio di sistema non di paging.
Sintassi
PVOID MmMapIoSpace(
[in] PHYSICAL_ADDRESS PhysicalAddress,
[in] SIZE_T NumberOfBytes,
[in] MEMORY_CACHING_TYPE CacheType
);
Parametri
[in] PhysicalAddress
Specifica l'indirizzo fisico iniziale dell'intervallo di I/O di cui eseguire il mapping.
[in] NumberOfBytes
Specifica un valore maggiore di zero, che indica il numero di byte di cui eseguire il mapping.
[in] CacheType
Specifica un valore MEMORY_CACHING_TYPE, che indica l'attributo della cache da usare per eseguire il mapping dell'intervallo di indirizzi fisici.
Valore restituito
MmMapIoSpace restituisce l'indirizzo virtuale di base che esegue il mapping dell'indirizzo fisico di base per l'intervallo. Se lo spazio per il mapping dell'intervallo non è sufficiente, restituisce NULL.
Osservazioni
Un driver deve chiamare questa routine durante l'avvio del dispositivo se riceve risorse convertite di tipo CmResourceTypeMemory in una struttura CM_PARTIAL_RESOURCE_DESCRIPTOR. MmMapIoSpace esegue il mapping dell'indirizzo fisico restituito nell'elenco di risorse a un indirizzo logico tramite il quale il driver può accedere ai registri del dispositivo.
MmMapIoSpace deve essere usato solo con pagine bloccate (appartengono alle pagine bloccate di uno spazio MDL o I/O), altrimenti il proprietario della memoria potrebbe liberarlo (o la memoria potrebbe essere inserita in/out e così via).
Ad esempio, i driver dei dispositivi PIO che allocano buffer di I/O a lungo termine possono chiamare questa routine per rendere tali buffer accessibili o per rendere accessibile la memoria del dispositivo.
Per altre informazioni sull'uso di questa routine, vedere Mapping indirizzi Bus-Relative a indirizzi virtuali.
Fabbisogno
Requisito | Valore |
---|---|
piattaforma di destinazione | Universale |
intestazione | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
libreria | NtosKrnl.lib |
dll | NtosKrnl.exe |
IRQL | IRQL <=DISPATCH_LEVEL |