Edit

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN structure (wdm.h)

  • Article

The IOMMU_DMA_LOGICAL_ADDRESS_TOKEN represents a reserved contiguous logical address range created by IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE. Logical address tokens guarantee that the logical address represented has all of its associated page tables allocated ahead of time, ensuring that future mappings to this region will not fail due to low memory conditions.

Syntax

typedef struct _IOMMU_DMA_LOGICAL_ADDRESS_TOKEN {
  IOMMU_DMA_LOGICAL_ADDRESS LogicalAddressBase;
  SIZE_T                    Size;
} IOMMU_DMA_LOGICAL_ADDRESS_TOKEN, *PIOMMU_DMA_LOGICAL_ADDRESS_TOKEN;

Members

LogicalAddressBase

Represents the base address of the logical address range.

Size

Represents the size, in bytes, of the logical address range.

Remarks

Logical Address tokens can be created and freed via IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE and IOMMU_FREE_RESERVED_LOGICAL_ADDRESS_RANGE.

Logical Address tokens should have portions of their logical address ranges mapped to and unmapped from physical addresses via IOMMU_MAP_RESERVED_LOGICAL_RANGE and IOMMU_UNMAP_RESERVED_LOGICAL_RANGE.

Requirements

Requirement Value
Minimum supported server Windows Server 2022
Header wdm.h (include Wdm.h)

See also

IOMMU_RESERVE_LOGICAL_ADDRESS_RANGE

IOMMU_FREE_RESERVED_LOGICAL_ADDRESS_RANGE

IOMMU_MAP_RESERVED_LOGICAL_RANGE

IOMMU_UNMAP_RESERVED_LOGICAL_RANGE

IOMMU_DMA_LOGICAL_ADDRESS_TOKEN_MAPPED_SEGMENT