IOMMU_DOMAIN_CREATE_EX Rückruffunktion (wdm.h)

Artikel
03/01/2024

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

Syntax

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

Konfigurationsflags 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 Zuordnungskonfiguration bereit, um einen durch HAL implementierten logischen Zuteilungsgeber zu initialisieren, der der Domäne zugeordnet werden soll. Siehe IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Stellt optional einen Satz 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 umfassen die folgenden status-Codes.

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Die Routine konnte die für die Domäne erforderlichen Ressourcen nicht zuordnen, oder es gibt nicht genügend ASIDs für nicht verwaltete Domänen.
STATUS_NOT_SUPPORTED	Die Hypervisordomänenschnittstelle ist nicht verfügbar, der 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-Werte.

Hinweise

Verwenden Sie IOMMU_DOMAIN_DELETE, um eine von IOMMU_DOMAIN_CREATE_EX erstellte Domäne zu löschen. Es gibt derzeit keine Ex-Entsprechung der Domänenlöschung.