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。 可能的错误返回值包括以下状态代码。
| 返回代码 | 说明 |
|---|---|
| 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) |