IOMMU_DOMAIN_CREATE_EX fonction de rappel (wdm.h)

Article
08/08/2023

Crée un domaine d’appareil DMA en fonction du type de domaine fourni.

Syntaxe

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

Paramètres

[in] DomainType

Indique le type de domaine à créer. Voir IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Indicateurs de configuration pour le domaine de l’appareil. Actuellement inutilisé et doit être défini sur 0. Voir IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Fournit éventuellement une configuration d’allocateur logique pour initialiser un allocateur logique implémenté par HAL à associer au domaine. Voir IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Fournit éventuellement un ensemble de structures IOMMU_DMA_RESERVED_REGION à réserver lors de la création du domaine.

[out] DomainOut

Retourne un handle opaque au domaine créé.

Valeur retournée

STATUS_SUCCESS si l’opération réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	La routine n’a pas pu allouer les ressources requises pour le domaine ou il n’y a pas suffisamment d’ASID pour les domaines non managés.
STATUS_NOT_SUPPORTED	L’interface de domaine de l’hyperviseur n’est pas disponible, l’ordinateur invité x86 qui tente de créer un domaine ou le type de domaine fourni n’est actuellement pas autorisé.

Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

Pour supprimer un domaine créé par IOMMU_DOMAIN_CREATE_EX, utilisez IOMMU_DOMAIN_DELETE ; il n’existe actuellement aucun équivalent Ex de la suppression de domaine.