IOMMU_DOMAIN_ATTACH_DEVICE回呼函式 (wdm.h)

將裝置連結至現有的網域。

語法

IOMMU_DOMAIN_ATTACH_DEVICE IommuDomainAttachDevice;

NTSTATUS IommuDomainAttachDevice(
  [_In_] PIOMMU_DMA_DOMAIN Domain,
  [_In_] PDEVICE_OBJECT PhysicalDeviceObject,
  [_In_] ULONG InputMappingIdBase,
  [_In_] ULONG MappingCount
)
{...}

參數

[_In_] Domain

網域句柄的指標。

[_In_] PhysicalDeviceObject

實體裝置物件的指標， (裝置堆疊中的 PDO) 。

[_In_] InputMappingIdBase

裝置所需數據流的輸入對應基底。

[_In_] MappingCount

從基底開始的對應計數。

傳回值

如果作業成功，則傳回STATUS_SUCCESS。 否則，傳回適當的NTSTATUS值錯誤碼。 如需詳細資訊，請參閱 NTSTATUS值。

備註

驅動程式必須負責確保此函式不會與相同裝置上的IOMMU_DOMAIN_DETACH_DEVICE或IOMMU_SET_DEVICE_FAULT_REPORTING呼叫同時呼叫。

InputMappingIdBase 和 MappingCount 僅適用於支援 ARM64 上多個串流標識符的 ACPI 列舉裝置。 對於任何其他裝置或架構，這些值必須是：

• InputMappingIdBase = 0

• MappingCount = 1

這已被取代。 請考慮使用 IOMMU_DOMAIN_ATTACH_DEVICE_EX 和 DMA_IOMMU_INTERFACE_EX。

規格需求

需求	值
最低支援的用戶端	Windows 10 (版本 1803)
標頭	wdm.h (包含 Wdm.h)