IOMMU_DOMAIN_CREATE_EX função de retorno de chamada (wdm.h)
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.
Requisitos
Requisito | Valor |
---|---|
servidor com suporte mínimo | Windows Server 2022 |
cabeçalho | wdm.h (inclua Wdm.h) |
Consulte também
IOMMU_DMA_DOMAIN_CREATION_FLAGS