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 ゲストコンピューターがドメインを作成しようとしている、または指定されたドメインの種類は現在許可されていません。