IOMMU_DOMAIN_CREATE_EX Rückruffunktion (wdm.h)
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Server) | Windows Server 2022 |
| Kopfzeile | wdm.h (einschließen von Wdm.h) |
Weitere Informationen
IOMMU_DMA_DOMAIN_CREATION_FLAGS