IOMMU_DOMAIN_ATTACH_DEVICE_EX回呼函式 (wdm.h)
將 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 |
---|---|
|
例程無法配置必要的資源。 |
|
裝置已連結至網域。 |
|
裝置目前不允許附加至此網域類型。 |
如需詳細資訊,請參閱 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 在可用網域類型變更時註冊通知回呼。
規格需求
需求 | 值 |
---|---|
最低支援的伺服器 | Windows Server 2022 |
標頭 | wdm.h (包含 Wdm.h) |
另請參閱
IOMMU_SET_DEVICE_FAULT_REPORTING_EX
IOMMU_DEVICE_QUERY_DOMAIN_TYPES