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)

另请参阅

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS