IOMMU_DOMAIN_CREATE_EX Rückruffunktion (wdm.h)

Artikel
07.02.2025

Erstellt eine neue DMA-Gerätedomäne basierend auf dem bereitgestellten Domänentyp.

Syntax

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

Parameter

[in] DomainType

Gibt den Typ der zu erstellenden Domäne an. Siehe IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Konfigurationskennzeichnungen für die Gerätedomäne. Derzeit nicht verwendet und muss auf 0 festgelegt werden. Siehe IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Optional stellt eine logische Zuweisungskonfiguration bereit, um einen durch HAL implementierten logischen Allocator zu initialisieren, der der Domäne zugeordnet werden soll. Siehe IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Stellt optional eine Reihe von IOMMU_DMA_RESERVED_REGION Strukturen bereit, die während der Domänenerstellung reserviert werden sollen.

[out] DomainOut

Gibt ein undurchsichtiges Handle für die erstellte Domäne zurück.

Rückgabewert

STATUS_SUCCESS, wenn der Vorgang erfolgreich ist. Mögliche Fehlerrückgabewerte sind die folgenden Statuscodes.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Die Routine konnte ressourcen nicht zuordnen, die für die Domäne erforderlich sind, oder es sind nicht genügend ASIDs für nicht verwaltete Domänen vorhanden.
STATUS_NOT_SUPPORTED	Die Hypervisor-Domänenschnittstelle ist nicht verfügbar, x86-Gastcomputer, der versucht, eine Domäne zu erstellen, oder der angegebene Domänentyp ist derzeit nicht zulässig.

Weitere Informationen finden Sie unter NTSTATUS Values.

Bemerkungen

Um eine von IOMMU_DOMAIN_CREATE_EXerstellte Domäne zu löschen, verwenden Sie IOMMU_DOMAIN_DELETE; zurzeit gibt es keine Ex-Entsprechung des Domänenlöschvorgangs.