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

Статья
02/07/2025

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

Синтаксис

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.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 1803
заголовка	wdm.h (include Wdm.h)

Поделиться через