IOMMU_MAP_RESERVED_LOGICAL_RANGE回呼函式 (wdm.h)

  • 發行項

對應保留的邏輯範圍。

不同於 IOMMU_MAP_LOGICAL_RANGE_EX，這保證不會執行任何記憶體配置，因為它們假設先前已使用 IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE 來執行。

語法

IOMMU_MAP_RESERVED_LOGICAL_RANGE IommuMapReservedLogicalRange;

NTSTATUS IommuMapReservedLogicalRange(
  [in, out] PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN LogicalAddressToken,
  [in]      SIZE_T Offset,
  [in]      ULONG Permissions,
  [in]      PIOMMU_MAP_PHYSICAL_ADDRESS PhysicalAddressToMap,
  [out]     PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT MappedSegment
)
{...}

參數

[in, out] LogicalAddressToken

要對應的 IOMMU_DMA_LOGICAL_ADDRESS_TOKEN 。

[in] Offset

位移，以位元組為單位，輸入邏輯位址令牌，代表要對應的基底邏輯位址。

[in] Permissions

位欄位元，表示要針對所對應範圍設定的許可權。 如需可用的許可權位，請參閱。

[in] PhysicalAddressToMap

將對應至網域 的IOMMU_MAP_PHYSICAL_ADDRESS 。

[out] MappedSegment

傳回 IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT 表示現在已對應的邏輯位址令牌區段。

傳回值

如果 作業成功，STATUS_SUCCESS。 可能的錯誤傳回值包括下列狀態代碼。

傳回碼 Description
STATUS_INVALID_PARAMETER_2 提供的位移未對齊頁面。
STATUS_INVALID_PARAMETER_4 提供的實體位址未對齊頁面，且/或不是大小為整數的頁面。
STATUS_RESOURCE_IN_USE 邏輯地址標記中所代表的邏輯位址範圍已經完全或部分對應。
STATUS_UNSUCCESSFUL 目前正在刪除邏輯位址令牌。

如需詳細資訊，請參閱 NTSTATUS值。

備註

邏輯位址令牌對應區段可以透過 IOMMU_UNMAP_RESERVED_LOGICAL_RANGE取消對應。

許可權欄位是一個位欄位字段，描述要對應之頁面的訪問許可權。

位的定義如下：

Bit 0 = Read Access

Bit 1 = Write Access

Bits 31-2 = Reserved (0)

規格需求

需求 值
最低支援的伺服器 Windows Server 2022
標頭 wdm.h (包含 Wdm.h)

另請參閱

IOMMU_UNMAP_RESERVED_LOGICAL_RANGE

IOMMU_MAP_PHYSICAL_ADDRESS

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT