IOMMU_DOMAIN_CREATE_EX callback function (wdm.h)

Article
02/25/2022

Creates a new DMA device domain based on the provided domain type.

Syntax

IOMMU_DOMAIN_CREATE_EX IommuDomainCreateEx;

NTSTATUS IommuDomainCreateEx(
  [in]           IOMMU_DMA_DOMAIN_TYPE DomainType,
  [in]           IOMMU_DMA_DOMAIN_CREATION_FLAGS Flags,
  [in, optional] PIOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG LogicalAllocatorConfig,
  [in, optional] PIOMMU_DMA_RESERVED_REGION ReservedRegions,
  [out]          PIOMMU_DMA_DOMAIN *DomainOut
)
{...}

Parameters

[in] DomainType

Indicates the type of domain to be created. See IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Configuration flags for the device domain. Currently unused and must be set to 0. See IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Optionally provides a logical allocator configuration to initialize a HAL-implemented logical allocator to be associated with the domain. See IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Optionally provides a set of IOMMU_DMA_RESERVED_REGION structures to be reserved during domain creation.

[out] DomainOut

Returns an opaque handle to the created domain.

Return value

STATUS_SUCCESS if the operation is successful. Possible error return values include the following status codes.

Return code	Description
STATUS_INSUFFICIENT_RESOURCES	The routine failed to allocate resources required for the domain or there are not enough ASIDs for unmanaged domains.
STATUS_NOT_SUPPORTED	The hypervisor domain interface not available, x86 guest machine attempting to create a domain, or provided domain type is currently not allowed.

For more information, see NTSTATUS Values.

Remarks

To delete a domain created by IOMMU_DOMAIN_CREATE_EX, use IOMMU_DOMAIN_DELETE; there currently is no Ex equivalent of domain deletion.

Requirements

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