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

  • Статья

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

Синтаксис

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 (включая Wdm.h)