IOMMU_DEVICE_QUERY_DOMAIN_TYPES fonction de rappel (wdm.h)

Article
02/27/2024

Requêtes pour les types disponibles de domaines auxquels un IOMMU_DMA_DEVICE est autorisé à attacher, en fonction de facteurs d’environnement, tels que la plateforme et la stratégie DMA Guard.

Syntaxe

IOMMU_DEVICE_QUERY_DOMAIN_TYPES IommuDeviceQueryDomainTypes;

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

Paramètres

DmaDevice

[In] Pointeur vers un jeton opaque représentant le IOMMU_DMA_DEVICE.

AvailableDomains

[Out] Retourne les types de domaine actuels qui peuvent être créés et attachés. Chaque bit défini représente un type de domaine disponible : (1 << IOMMU_DMA_DOMAIN_TYPE). Voir IOMMU_DMA_DOMAIN_TYPE.

Valeur de retour

None

Remarques

Cela peut être utilisé comme indicateur pour déterminer si IOMMU_DOMAIN_ATTACH_DEVICE_EX réussira.

Si un appareil n’est pas derrière un iommu de réapping compatible avec DMA, aucun domaine de réapping n’est disponible.

Si DMA Guard est activé, les domaines de transfert peuvent être disponibles en fonction de la stratégie, c’est-à-dire si l’appareil est choisi dans la mise à jour DMA, s’il est connecté en externe, si l’état de verrouillage de l’écran, etc.. Si le blocage DMA Guard est actif, les domaines de passage ne sont pas disponibles et AvailableDomains & (1 << DomainTypePassThrough) entraînent 0.

Pour être informé de la disponibilité des types de domaine, envisagez d’utiliser IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK pour inscrire un rappel de notification chaque fois que les types de domaine disponibles changent.