IOMMU_DOMAIN_ATTACH_DEVICE_EX回呼函式 (wdm.h)

發行項
02/27/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。可能的錯誤傳回值包括下列狀態代碼。

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