IOMMU_DOMAIN_ATTACH_DEVICE_EX回调函数 (wdm.h)

项目
02/29/2024

将 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_DOMAIN_DETACH_DEVICE_EX将IOMMU_DMA_DEVICE从任何先前附加的域分离，然后再尝试将其附加到另一个域。

驱动程序负责确保此函数不会与同一设备上的任何 IOMMU_DOMAIN_DETACH_DEVICE_EX 或 IOMMU_SET_DEVICE_FAULT_REPORTING_EX 调用同时调用。

如果 STATUS_ACCESS_DENIED 返回，则域类型当前可能不适用于设备要附加到的域类型。建议利用 IOMMU_DEVICE_QUERY_DOMAIN_TYPES 来确定哪些域类型可用于指定设备。可用类型可能因 DMA 防护策略和设备特征而异。若要在域类型可用时收到通知，请考虑使用 IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK 在可用域类型更改时注册通知回调。