Condividi tramite


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

Vedere anche

MmAllocateContiguousMemory

MmAllocateNonCachedMemory

MmMapLockedPages

MmUnmapIoSpace