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

[in]IOMMU_DMA_DEVICE 要附加到的域的句柄。

DmaDevice

[in]指向要附加的 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 注册通知回调。