IOMMU_MAP_PHYSICAL_ADDRESS structure (wdm.h)

The IOMMU_MAP_PHYSICAL_ADDRESS represents a physical address that is to be mapped to a logical address. It is used by IOMMU_MAP_LOGICAL_RANGE_EX and IOMMU_MAP_IDENTITY_RANGE_EX.

Syntax

typedef struct _IOMMU_MAP_PHYSICAL_ADDRESS {
 IOMMU_MAP_PHYSICAL_ADDRESS_TYPE MapType;
 union {
 struct {
 PMDL Mdl;
 } Mdl;
 struct {
 PHYSICAL_ADDRESS Base;
 SIZE_T Size;
 } ContiguousRange;
 struct {
 PPFN_NUMBER PageFrame;
 SIZE_T NumberOfPages;
 } PfnArray;
 };
} IOMMU_MAP_PHYSICAL_ADDRESS, *PIOMMU_MAP_PHYSICAL_ADDRESS;

Members

MapType

A IOMMU_MAP_PHYSICAL_ADDRESS_TYPE value that indicates the format the physical address is represented in.

Mdl

If MapType == MapPhysicalAddressMdl, provides a MDL that represents the physical address.

Mdl.Mdl

The pointer to the MDL that represents the physical address.

ContiguousRange

If MapType == MapPhysicalAddressContiguousRange, provides a contiguous physical address.

ContiguousRange.Base

The base address of a contiguous physical address.

ContiguousRange.Size

The size, in bytes, of a contiguous physical address.

PfnArray

If MapType == MapPhysicalAddressPfn, provides a PFN array.

PfnArray.PageFrame

The pointer to the PFN array.

PfnArray.NumberOfPages

The number of PFNs in the PFN array.

Remarks

When mapping a physical address using IOMMU_MAP_LOGICAL_RANGE_EX or IOMMU_MAP_IDENTITY_RANGE_EX, the physical addresses represented must be 4K page aligned and 4K page length.

Requirements

See also

IOMMU_MAP_LOGICAL_RANGE_EX

IOMMU_MAP_IDENTITY_RANGE_EX

IOMMU_MAP_PHYSICAL_ADDRESS_TYPE