IOMMU_DEVICE_QUERY_DOMAIN_TYPES funzione di callback (wdm.h)

Articolo
02/27/2024

Le query per i tipi di domini disponibili a cui è consentita l'associazione di un IOMMU_DMA_DEVICE , a seconda dei fattori di ambiente, ad esempio la piattaforma e i criteri di DMA Guard.

Sintassi

IOMMU_DEVICE_QUERY_DOMAIN_TYPES IommuDeviceQueryDomainTypes;

void IommuDeviceQueryDomainTypes(
  PIOMMU_DMA_DEVICE DmaDevice,
  PULONG AvailableDomains
)
{...}

Parametri

DmaDevice

[In] Puntatore a un token opaco che rappresenta il IOMMU_DMA_DEVICE.

AvailableDomains

[Out] Restituisce i tipi di dominio correnti a cui è possibile creare e collegare. Ogni bit set rappresenta un tipo di dominio disponibile: (1 << IOMMU_DMA_DOMAIN_TYPE). Vedere IOMMU_DMA_DOMAIN_TYPE.

Valore restituito

nessuno

Osservazioni

Questa operazione può essere usata come hint per determinare se IOMMU_DOMAIN_ATTACH_DEVICE_EX avrà esito positivo.

Se un dispositivo non è dietro un remamapping compatibile di IOMMU, non sarà disponibile alcun dominio di remapping.

Se DMA Guard è abilitato, i domini pass-through possono essere disponibili in base ai criteri, ad esempio se il dispositivo è consenso esplicito sulla ripetizione del mapping DMA, è connesso esternamente, lo stato di blocco dello schermo e così via. Se il blocco di DMA Guard è attivo, i domini pass-through non saranno disponibili e AvailableDomains & (1 << DomainTypePassThrough) genereranno 0.

Per ricevere una notifica quando sono disponibili 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.