IOMMU_DOMAIN_CREATE_EX funzione di callback (wdm.h)

Articolo
02/29/2024

Crea un nuovo dominio del dispositivo DMA in base al tipo di dominio specificato.

Sintassi

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

Parametri

[in] DomainType

Indica il tipo di dominio da creare. Vedere IOMMU_DMA_DOMAIN_TYPE.

[in] Flags

Flag di configurazione per il dominio del dispositivo. Attualmente inutilizzato e deve essere impostato su 0. Vedere IOMMU_DMA_DOMAIN_CREATION_FLAGS.

[in, optional] LogicalAllocatorConfig

Facoltativamente, fornisce una configurazione dell'allocatore logico per inizializzare un allocatore logico implementato da HAL da associare al dominio. Vedere IOMMU_DMA_LOGICAL_ALLOCATOR_CONFIG.

[in, optional] ReservedRegions

Facoltativamente, fornisce un set di strutture IOMMU_DMA_RESERVED_REGION da riservare durante la creazione del dominio.

[out] DomainOut

Restituisce un handle opaco al dominio creato.

Valore restituito

STATUS_SUCCESS se l'operazione ha esito positivo. I valori restituiti di errore possibili includono i codici di stato seguenti.

Codice restituito	Descrizione
STATUS_INSUFFICIENT_RESOURCES	La routine non è riuscita ad allocare le risorse necessarie per il dominio o non sono disponibili ASID sufficienti per i domini non gestiti.
STATUS_NOT_SUPPORTED	L'interfaccia di dominio dell'hypervisor non è disponibile, il computer guest x86 che tenta di creare un dominio o il tipo di dominio specificato non è attualmente consentito.

Per altre informazioni, vedere Valori NTSTATUS.

Commenti

Per eliminare un dominio creato da IOMMU_DOMAIN_CREATE_EX, usare IOMMU_DOMAIN_DELETE; attualmente non esiste un equivalente ex dell'eliminazione del dominio.