IoGetIommuInterfaceEx function (wdm.h)

Article
02/25/2022

Retrieves a pointer to the extended interface that contains a set of IOMMU routines.

Syntax

NTSTATUS IoGetIommuInterfaceEx(
  ULONG                   Version,
  ULONGLONG               Flags,
  PDMA_IOMMU_INTERFACE_EX InterfaceOut
);

Parameters

Version

[In] The interface version that determines the set of IOMMU routines that are returned.

Flags

[In] Configuration flags for the interface. Currently unused.

InterfaceOut

[Out] A pointer to a DMA_IOMMU_INTERFACE_EX structure that contains pointers to IOMMU interface routines for device domain operations.

Return value

This function returns NTKERNELAPI NTSTATUS.

Remarks

To use the IOMMU routines provided by the interface, the device driver must be opted into DMA remapping via the DmaRemappingCompatible registry key value (set to 1).

This supersedes the deprecated IoGetIommuInterface function. Use this Ex one for all versions of IOMMU routines.

Requirements

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