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

Статья
02/07/2025

Отсоединяет устройство от существующего домена.

Синтаксис

IOMMU_DOMAIN_DETACH_DEVICE IommuDomainDetachDevice;

NTSTATUS IommuDomainDetachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingId
)
{...}

Параметры

[_In_] Domain

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

[_In_] PhysicalDeviceObject

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

[_In_] InputMappingId

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

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

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

Замечания

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

InputMappingId используется только для устройств с перечислением ACPI на ARM64. Во всех остальных случаях это значение должно быть равно нулю.

Если несколько устройств одновременно подключены с помощью значения MappingCount, указанного в вызове IOMMU_DOMAIN_ATTACH_DEVICE, эти устройства можно отсоединить только как группу, указав значение InputMappingId, равное значению InputMappingIdBase значение [IOMMU_DOMAIN_ATTACH_DEVICE], используемое при присоединении.

Это не рекомендуется. Рассмотрите возможность использования IOMMU_DOMAIN_DETACH_DEVICE_EX и DMA_IOMMU_INTERFACE_EX.

Требования

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

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