IOMMU_DOMAIN_DETACH_DEVICE fonction de rappel (wdm.h)

Article
02/29/2024

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 du domaine.

[_In_] PhysicalDeviceObject

Pointeur de l’objet d’appareil physique (PDO) dans la pile de périphériques de l’appareil.

[_In_] InputMappingId

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

Valeur retournée

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. Dans 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 de IOMMU_DOMAIN_ATTACH_DEVICE , ces appareils peuvent uniquement être détachés en tant que groupe en spécifiant une valeur InputMappingId qui est égale à la valeur InputMappingIdBase de [IOMMU_DOMAIN_ATTACH_DEVICE] utilisée lors de l’attachement.

Cette option est déconseillée. Envisagez d’utiliser IOMMU_DOMAIN_DETACH_DEVICE_EX et DMA_IOMMU_INTERFACE_EX.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 10 version 1803
En-tête	wdm.h (include Wdm.h)

Partager via