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。可能的錯誤傳回值包括下列狀態代碼。

傳回碼	Description
STATUS_INSUFFICIENT_RESOURCES	例程無法配置網域所需的資源，或非受控網域沒有足夠的 ASID。
STATUS_NOT_SUPPORTED	目前不允許 Hypervisor 網域介面、嘗試建立網域的 x86 客體計算機，或目前不允許提供網域類型。