IOMMU_DOMAIN_ATTACH_DEVICE_EX funzione di callback (wdm.h)

Articolo
02/27/2024

Collega un IOMMU_DMA_DEVICE a un dominio del dispositivo DMA esistente.

Sintassi

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

Parametri

Domain

[In] Handle al dominio a cui verrà associato il IOMMU_DMA_DEVICE .

DmaDevice

[In] Puntatore al IOMMU_DMA_DEVICE da collegare.

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.
STATUS_INVALID_PARAMETER	Il dispositivo è già collegato a un dominio.
STATUS_ACCESS_DENIED	Il dispositivo non è attualmente autorizzato a connettersi a questo tipo di dominio.

Per altre informazioni, vedere Valori NTSTATUS.

Commenti

Il chiamante è responsabile di garantire che il IOMMU_DMA_DEVICE venga prima scollegato, usando IOMMU_DOMAIN_DETACH_DEVICE_EX, da qualsiasi dominio collegato in precedenza prima di tentare di collegarlo a un altro dominio.

È responsabilità del driver assicurarsi che questa funzione non venga chiamata simultaneamente con qualsiasi IOMMU_DOMAIN_DETACH_DEVICE_EX o IOMMU_SET_DEVICE_FAULT_REPORTING_EX chiamate sullo stesso dispositivo.

Se STATUS_ACCESS_DENIED viene restituito, è probabile che il tipo di dominio non sia attualmente disponibile per il dispositivo a cui connettersi. È consigliabile utilizzare IOMMU_DEVICE_QUERY_DOMAIN_TYPES per determinare quali tipi di dominio sono disponibili per il dispositivo specificato. I tipi disponibili possono variare a seconda dei criteri di DMA Guard e delle caratteristiche del dispositivo. Per ricevere una notifica quando sono disponibili i tipi di dominio, è consigliabile usare IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK per registrare un callback di notifica ogni volta che i tipi di dominio disponibili cambiano.