IOMMU_DOMAIN_DETACH_DEVICE fonction de rappel (wdm.h)

Article
02/07/2025

Détache un appareil d’un domaine existant.

Syntaxe

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

NTSTATUS IommuDomainDetachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingId
)
{...}

Paramètres

[_In_] Domain

Pointeur vers le handle vers le domaine.

[_In_] PhysicalDeviceObject

Pointeur de l’objet d’appareil physique (PDO) dans la pile d’appareils de l’appareil.

[_In_] InputMappingId

Mappage d’entrée pour le flux souhaité de l’appareil.

Valeur de retour

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur NTSTATUS Values approprié. Pour plus d’informations, consultez valeurs NTSTATUS.

Remarques

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

InputMappingId est utilisé uniquement pour les appareils énumérés par ACPI sur ARM64. Pour tous les autres cas, cette valeur doit être égale à zéro.

Si plusieurs appareils sont joints simultanément à l’aide de la valeur MappingCount spécifiée dans l’appel IOMMU_DOMAIN_ATTACH_DEVICE, ces appareils ne peuvent être détachés qu’en tant que groupe en spécifiant une valeur InputMappingId égale à la valeur InputMappingIdBase de [IOMMU_DOMAIN_ATTACH_DEVICE] utilisée lors de l’attachement.

Cela est déconseillé. Envisagez d’utiliser IOMMU_DOMAIN_DETACH_DEVICE_EX et DMA_IOMMU_INTERFACE_EX.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 10, version 1803
d’en-tête	wdm.h (include Wdm.h)

Partager via