функция обратного вызова IOMMU_DOMAIN_ATTACH_DEVICE (wdm.h)

Присоединяет устройство к существующему домену.

Синтаксис

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

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

Параметры

[_In_] Domain

Указатель на дескриптор домена.

[_In_] PhysicalDeviceObject

Указатель на объект физического устройства (PDO) в стеке устройства.

[_In_] InputMappingIdBase

База сопоставления входных данных для требуемого потока устройства.

[_In_] MappingCount

Число сопоставлений, начиная с базы.

Возвращаемое значение

Если операция выполнена успешно, возвращается STATUS_SUCCESS. В противном случае возвращается соответствующий код ошибки значений NTSTATUS. Дополнительные сведения см. в разделе Значения NTSTATUS.

Комментарии

Драйвер отвечает за то, чтобы эта функция не вызывалась одновременно с IOMMU_DOMAIN_DETACH_DEVICE или IOMMU_SET_DEVICE_FAULT_REPORTING вызовами на одном устройстве.

InputMappingIdBase и MappingCount предназначены только для устройств с перечислением ACPI, поддерживающих несколько идентификаторов потоков в ARM64. Для любого другого устройства или архитектуры эти значения должны быть следующими:

• InputMappingIdBase = 0

• MappingCount = 1

Мы не рекомендуем использовать этот метод. Рассмотрите возможность использования IOMMU_DOMAIN_ATTACH_DEVICE_EX и DMA_IOMMU_INTERFACE_EX.

Требования