IOMMU_DOMAIN_CREATE_EX función de devolución de llamada (wdm.h)

Artículo
02/27/2024

Crea un nuevo dominio de dispositivo DMA basado en el tipo de dominio proporcionado.

Sintaxis

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 el tipo de dominio que se va a crear. Consulte IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Marcas de configuración para el dominio de dispositivo. Actualmente no se está usando y debe establecerse en 0. Consulte IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Opcionalmente, proporciona una configuración de asignador lógico para inicializar un asignador lógico implementado por HAL que se asociará al dominio. Consulte IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Opcionalmente, proporciona un conjunto de estructuras de IOMMU_DMA_RESERVED_REGION que se van a reservar durante la creación del dominio.

[out] DomainOut

Devuelve un identificador opaco al dominio creado.

Valor devuelto

STATUS_SUCCESS si la operación se realiza correctamente. Entre los posibles valores devueltos de error se incluyen los siguientes códigos de estado.

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	La rutina no pudo asignar recursos necesarios para el dominio o no hay suficientes ASID para dominios no administrados.
STATUS_NOT_SUPPORTED	La interfaz de dominio del hipervisor no está disponible, la máquina invitada x86 que intenta crear un dominio o el tipo de dominio proporcionado no está permitido actualmente.

Para obtener más información, vea Valores NTSTATUS.

Comentarios

Para eliminar un dominio creado por IOMMU_DOMAIN_CREATE_EX, use IOMMU_DOMAIN_DELETE; actualmente no hay ningún equivalente ex de eliminación de dominio.