IOMMU_DOMAIN_CREATE_EX função de retorno de chamada (wdm.h)

Artigo
02/07/2025

Cria um novo domínio de dispositivo DMA com base no tipo de domínio fornecido.

Sintaxe

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

Parâmetros

[in] DomainType

Indica o tipo de domínio a ser criado. Veja IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Sinalizadores de configuração para o domínio do dispositivo. Atualmente não utilizado e deve ser definido como 0. Consulte IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Opcionalmente, fornece uma configuração de alocador lógico para inicializar um alocador lógico implementado por HAL a ser associado ao domínio. Consulte IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Opcionalmente, fornece um conjunto de estruturas de IOMMU_DMA_RESERVED_REGION a serem reservadas durante a criação do domínio.

[out] DomainOut

Retorna um identificador opaco para o domínio criado.

Valor de retorno

STATUS_SUCCESS se a operação for bem-sucedida. Os valores de retorno de erro possíveis incluem os seguintes códigos de status.

Código de retorno	Descrição
STATUS_INSUFFICIENT_RESOURCES	A rotina falhou ao alocar recursos necessários para o domínio ou não há ASIDs suficientes para domínios não gerenciados.
STATUS_NOT_SUPPORTED	A interface de domínio do hipervisor não está disponível, o computador convidado x86 tentando criar um domínio ou o tipo de domínio fornecido atualmente não é permitido.

Para obter mais informações, consulte valores NTSTATUS.

Observações

Para excluir um domínio criado por IOMMU_DOMAIN_CREATE_EX, use IOMMU_DOMAIN_DELETE; atualmente, não há nenhum ex equivalente à exclusão de domínio.