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