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

Статья
08/08/2023

Присоединяет 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 для регистрации обратного вызова уведомления при каждом изменении доступных типов доменов.