指定されたドメインの種類に基づいて、新しい 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 ゲスト コンピューター、または指定されたドメインの種類は現在許可されていません。 |
詳細については、「NTSTATUS 値 を参照してください。
備考
IOMMU_DOMAIN_CREATE_EXによって作成されたドメインを削除するには、IOMMU_DOMAIN_DELETEを使用します。現在、ドメインの削除に相当する例はありません。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小サーバー | Windows Server 2022 |
| ヘッダー | wdm.h (Wdm.h を含む) |
関連項目
IOMMU_DMA_DOMAIN_CREATION_FLAGS