IOMMU_DOMAIN_CREATE_EX 콜백 함수(wdm.h)

아티클
02/29/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 게스트 컴퓨터 또는 제공된 도메인 유형은 현재 허용되지 않습니다.