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

Статья
02/07/2025

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

Синтаксис

IOMMU_DOMAIN_ATTACH_DEVICE_EX IommuDomainAttachDeviceEx;

NTSTATUS IommuDomainAttachDeviceEx(
  PIOMMU_DMA_DOMAIN Domain,
  PIOMMU_DMA_DEVICE DmaDevice
)
{...}

Параметры

Domain

[В] Дескриптор домена, к которому будет присоединен IOMMU_DMA_DEVICE.

DmaDevice

[В] Указатель на присоединение IOMMU_DMA_DEVICE.

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

STATUS_SUCCESS, если операция выполнена успешно. Возможные значения возвращаемых ошибок включают следующие коды состояния.

Возвращаемый код	Описание
STATUS_INSUFFICIENT_RESOURCES	Подпрограмма не удалось выделить необходимые ресурсы.
STATUS_INVALID_PARAMETER	Устройство уже подключено к домену.
STATUS_ACCESS_DENIED	В настоящее время устройство не может присоединиться к этому типу домена.

Дополнительные сведения см. в значения NTSTATUS.

Замечания

Вызывающий объект отвечает за то, что IOMMU_DMA_DEVICE сначала отсоединяется, используя IOMMU_DOMAIN_DETACH_DEVICE_EX, от любого ранее присоединенного домена, прежде чем пытаться подключить его к другому домену.

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

Если возвращается STATUS_ACCESS_DENIED, скорее всего, тип домена недоступен для подключения устройства. Рекомендуется использовать IOMMU_DEVICE_QUERY_DOMAIN_TYPES, чтобы определить, какие типы доменов доступны для указанного устройства. Доступные типы могут отличаться в зависимости от политики DMA Guard и характеристик устройства. Чтобы получать уведомления о доступности типов доменов, рекомендуется использовать IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK для регистрации обратного вызова уведомлений при изменении доступных типов доменов.