IOMMU_DOMAIN_ATTACH_DEVICE fonction de rappel (wdm.h)

  • Article

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

[_In_] PhysicalDeviceObject

Pointeur de l’objet d’appareil physique (PDO) dans la pile de périphériques 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 retournée

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

Cette option est déconseillée. Envisagez d’utiliser IOMMU_DOMAIN_ATTACH_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)