IOMMU_DOMAIN_CREATE_EX fonction de rappel (wdm.h)

Article
2025-02-07

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

Syntaxe

C++

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

Vous pouvez éventuellement fournir 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 de retour

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

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	La routine n’a pas pu allouer des 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 hyperviseur non 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 suppression de domaine.