IOMMU_DOMAIN_CREATE_EX回调函数 (wdm.h)

项目
02/27/2024

基于提供的域类型创建新的 DMA 设备域。

语法

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
)
{...}

参数

[in] DomainType

指示要创建的域的类型。请参阅 IOMMU_DMA_DOMAIN_TYPE。

[in] Flags

设备域的配置标志。当前未使用，并且必须设置为 0。请参阅 IOMMU_DMA_DOMAIN_CREATION_FLAGS。

[in, optional] LogicalAllocatorConfig

（可选）提供逻辑分配器配置，以初始化要与域关联的 HAL 实现的逻辑分配器。请参阅 IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG。

[in, optional] ReservedRegions

（可选）提供一组在创建域期间保留 的IOMMU_DMA_RESERVED_REGION 结构。

[out] DomainOut

返回所创建域的不透明句柄。

返回值

如果操作成功，STATUS_SUCCESS。可能的错误返回值包括以下状态代码。

返回代码	说明
STATUS_INSUFFICIENT_RESOURCES	例程未能分配域所需的资源，或者没有足够的 ASID 用于非托管域。
STATUS_NOT_SUPPORTED	目前不允许虚拟机监控程序域接口不可用、尝试创建域的 x86 来宾计算机或提供的域类型。