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)

另請參閱

IOMMU_DMA_DOMAIN_TYPE

DMA_IOMMU_INTERFACE_V2

DMA_IOMMU_INTERFACE_EX

IOMMU_MAP_PHYSICAL_ADDRESS