IOMMU_MAP_IDENTITY_RANGE_EX回呼函式 (wdm.h)
為提供的網域中提供的實體位址空間建立身分識別對應。
語法
IOMMU_MAP_IDENTITY_RANGE_EX IommuMapIdentityRangeEx;
NTSTATUS IommuMapIdentityRangeEx(
[in] PIOMMU_DMA_DOMAIN Domain,
[in] ULONG Permissions,
[in] PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap
)
{...}
參數
[in] Domain
識別對應實體地址所屬 IOMMU_DMA_DOMAIN 指標。 網域的類型必須是 DomainTypeTranslate 或 DomainTypePassThrough。 如需網域類型的詳細資訊，請參閱 IOMMU_DMA_DOMAIN_TYPE。
[in] Permissions
位欄位元，表示要為所對應範圍設定的許可權。 如需可用的許可權位，請參閱。
[in] PhysicalAddressToMap
將對應至網域 的IOMMU_MAP_PHYSICAL_ADDRESS 。
傳回值
如果作業成功，STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。
| 傳回碼 | Description |
|---|---|
| STATUS_INVALID_PARAMETER_1 | 提供的網域不是 DomainTypeTranslate 或 DomainTypePassThrough 類型。 |
| STATUS_INVALID_PARAMETER_3 | 提供的 IOMMU_MAP_PHYSICAL_ADDRESS 並不代表分頁對齊的實體記憶體，而且大小為PAGE_SIZE的倍數。 |
| STATUS_IN_USE | 識別範圍已經對應或部分對應。 |
| STATUS_NOT_SUPPORTED | 提供的網域包含不允許明確邏輯位址配置的邏輯配置器。 |
備註
若要取消對應 IOMMU_MAP_IDENTITY_RANGE_EX所建立的邏輯位址，請使用 IOMMU_UNMAP_IDENTITY_RANGE_EX。
許可權欄位是一個位欄位字段，描述要對應之頁面的訪問許可權。
位的定義如下：
Bit 0 = Read Access
Bit 1 = Write Access
Bits 31-2 = Reserved (0)
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的伺服器 | Windows Server 2022 |
| 標頭 | wdm.h (包含 Wdm.h) |