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_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 Guard 原則和裝置特性而有所不同。若要在網域類型可用時收到通知，請考慮在可用網域類型變更時使用 IOMMU_REGISTER_INTERFACE_STATE_CHANGE_CALLBACK 註冊通知回呼。