IOMMU_MAP_IDENTITY_RANGE_EX funzione di callback (wdm.h)
Crea un mapping di identità per uno spazio indirizzi fisico specificato nel dominio specificato.
Sintassi
IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;
NTSTATUS IommuMapIdentityRangeEx(
[in] PIOMMU_DMA_DOMAIN Domain,
[in] ULONG Permissions,
[in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}
Parametri
[in] Domain
Puntatore al IOMMU_DMA_DOMAIN a cui appartiene l'indirizzo fisico mappato all'identità. Il dominio deve essere di tipo DomainTypeTranslate o DomainTypePassThrough. Per altre informazioni sui tipi di dominio, vedere IOMMU_DMA_DOMAIN_TYPE.
[in] Permissions
Campo di bit che rappresenta le autorizzazioni da impostare per l'intervallo di cui viene eseguito il mapping. Per i bit di autorizzazione disponibili, vedere la sezione Note.
[in] PhysicalAddressToMap
Il IOMMU_MAP_PHYSICAL_ADDRESS di cui verrà eseguito il mapping al dominio.
Valore restituito
STATUS_SUCCESS se l'operazione ha esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.
| Codice restituito | Descrizione |
|---|---|
| STATUS_INVALID_PARAMETER_1 | Il dominio specificato non è di tipo DomainTypeTranslate o DomainTypePassThrough. |
| STATUS_INVALID_PARAMETER_3 | Il IOMMU_MAP_PHYSICAL_ADDRESS fornito non rappresenta la memoria fisica allineata alla pagina e ha una dimensione multipla di PAGE_SIZE. |
| STATUS_IN_USE | L'intervallo di valori Identity è già mappato o parzialmente mappato. |
| STATUS_NOT_SUPPORTED | Il dominio fornito contiene un allocatore logico che non consente l'allocazione esplicita degli indirizzi logici. |
Commenti
Per rimuovere il mapping dell'indirizzo logico creato da IOMMU_MAP_IDENTITY_RANGE_EX, usare IOMMU_UNMAP_IDENTITY_RANGE_EX.
Il campo autorizzazioni è un campo di bit che descrive le autorizzazioni di accesso per le pagine di cui eseguire il mapping.
I bit sono definiti come segue:
Bit 0 = Read Access
Bit 1 = Write Access
Bits 31-2 = Reserved (0)
Requisiti
| Requisito | Valore |
|---|---|
| Server minimo supportato | Windows Server 2022 |
| Intestazione | wdm.h (include Wdm.h) |