IOMMU_DEVICE_QUERY_DOMAIN_TYPES función de devolución de llamada (wdm.h)

Artículo
08/08/2023

Consultas para los tipos de dominios disponibles a los que se permite asociar un IOMMU_DMA_DEVICE , en función de los factores del entorno, como la plataforma y la directiva de protección DMA.

Sintaxis

IOMMU_DEVICE_QUERY_DOMAIN_TYPES IommuDeviceQueryDomainTypes;

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

Parámetros

DmaDevice

[In] Puntero a un token opaco que representa el IOMMU_DMA_DEVICE.

AvailableDomains

[Salida] Devuelve los tipos de dominio actuales a los que están disponibles para crearse y adjuntarse. Cada bit establecido representa un tipo de dominio disponible: (1 << IOMMU_DMA_DOMAIN_TYPE). Consulte IOMMU_DMA_DOMAIN_TYPE.

Valor devuelto

None

Observaciones

Esto se puede usar como sugerencia sobre si IOMMU_DOMAIN_ATTACH_DEVICE_EX se realizará correctamente.

Si un dispositivo no está detrás de una IOMMU compatible con la reasignación de DMA, no habrá ningún dominio de reasignación disponible.

Si DMA Guard está habilitado, es posible que los dominios de paso a través estén disponibles en función de la directiva, es decir, si el dispositivo ha optado por la reasignación de DMA, se conecta externamente, el estado de bloqueo de pantalla, etc. Si el bloqueo de DMA Guard está activo, los dominios de paso a través no estarán disponibles y AvailableDomains & (1 << DomainTypePassThrough) darán como resultado 0.

Para recibir notificaciones de cuándo hay tipos de dominio disponibles, considere la posibilidad de usar IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK para registrar una devolución de llamada de notificación siempre que cambien los tipos de dominio disponibles.