IOMMU_DOMAIN_ATTACH_DEVICE fonction de rappel (wdm.h)

Article
02/07/2025

Attache un appareil à un domaine existant.

Syntaxe

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

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_] InputMappingIdBase

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

[_In_] MappingCount

Nombre de mappages commençant à la base.

Valeur de retour

Retournez STATUS_SUCCESS si l’opération réussit. Sinon, retournez un code d’erreur de valeurs NTSTATUS 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_DETACH_DEVICE ou IOMMU_SET_DEVICE_FAULT_REPORTING appels sur le même appareil.

InputMappingIdBase et MappingCount sont destinés uniquement à prendre en charge les appareils énumérés PAR ACPI qui prennent en charge plusieurs ID de flux sur ARM64. Pour tout autre appareil ou architecture, ces valeurs doivent être les suivantes :

InputMappingIdBase = 0
MappingCount = 1

Cela est déconseillé. Envisagez d’utiliser IOMMU_DOMAIN_ATTACH_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