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 上多个流 ID 的 ACPI 枚举设备。 对于任何其他设备或体系结构，这些值必须是：

• InputMappingIdBase = 0

• MappingCount = 1

此方法已弃用。 请考虑使用 IOMMU_DOMAIN_ATTACH_DEVICE_EX 和 DMA_IOMMU_INTERFACE_EX。

要求

要求	值
最低受支持的客户端	Windows 10 版本 1803
标头	wdm.h (包括 Wdm.h)