IOMMU_DOMAIN_ATTACH_DEVICE_EX fonction de rappel (wdm.h)

Article
08/08/2023

Attache un IOMMU_DMA_DEVICE à un domaine d’appareil DMA existant.

Syntaxe

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

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

Paramètres

Domain

[In] Handle au domaine auquel le IOMMU_DMA_DEVICE attacher.

DmaDevice

[In] Pointeur vers le IOMMU_DMA_DEVICE à attacher.

Valeur retournée

STATUS_SUCCESS si l’opération réussit. Les valeurs de retour d’erreur possibles incluent les codes status suivants.

Code de retour	Description
STATUS_INSUFFICIENT_RESOURCES	La routine n’a pas pu allouer les ressources requises.
STATUS_INVALID_PARAMETER	L’appareil est déjà attaché à un domaine.
STATUS_ACCESS_DENIED	L’appareil n’est actuellement pas autorisé à s’attacher à ce type de domaine.

Pour plus d’informations, consultez Valeurs NTSTATUS.

Remarques

L’appelant est chargé de s’assurer que le IOMMU_DMA_DEVICE est d’abord détaché, à l’aide de IOMMU_DOMAIN_DETACH_DEVICE_EX, de tout domaine précédemment attaché avant de tenter de l’attacher à un autre domaine.

Il incombe au pilote de s’assurer que cette fonction n’est pas appelée simultanément avec les appels IOMMU_DOMAIN_DETACH_DEVICE_EX ou IOMMU_SET_DEVICE_FAULT_REPORTING_EX sur le même appareil.

Si STATUS_ACCESS_DENIED est retourné, il est probable que le type de domaine n’est pas actuellement disponible pour l’appareil à attacher. Il est recommandé d’utiliser IOMMU_DEVICE_QUERY_DOMAIN_TYPES pour déterminer quels types de domaine sont disponibles pour l’appareil spécifié. Les types disponibles peuvent varier en fonction de la stratégie DMA Guard et des caractéristiques de l’appareil. Pour être averti 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.