为设备驱动程序启用 DMA 重新映射

为了确保与 内核 DMA 保护DMAGuard 策略兼容,PCIe 设备驱动程序可以选择重新映射直接内存访问(DMA)。

设备驱动程序的 DMA 重新映射可防止内存损坏和恶意 DMA 攻击,并为设备提供更高级别的兼容性。 此外,具有 DMA 重新映射兼容驱动程序的设备可以启动和执行 DMA,而不考虑锁屏状态。

在启用了内核 DMA 保护的系统上,DMAGuard 策略可能会阻止使用与 DMA 重新映射不兼容的驱动程序连接到 外部/暴露的 PCIe 端口的设备(例如 M.2、Thunderbolt™),这取决于系统管理员设置的策略值。

关于启用和选择加入 DMA 重新映射的驱动程序要求

驱动程序使用以下接口执行 DMA:

若要调整驱动程序的 DMA 重新映射策略,请添加 INF 指令。 可以通过两种方法实现上述目的:按设备(强烈建议和首选)机制和按驱动程序(旧式)机制。

按设备选择加入机制

对于 Windows 24H2 及更高版本,请使用此按设备方法。 请注意,如果存在此按设备选择加入方法,则此方法将完全覆盖旧式按驱动程序方法(即如果设置了 RemappingSupported,则会忽略 DmaRemappingCompatible 键)。

将 INF 指令(如以下内容)添加到设备枚举部分:

 [MyDriver_Device.NT.HW]
 AddReg=DMA_Remapping_OptIn_AddReg
 
 [DMA_Remapping_OptIn_AddReg]
 HKR,"DMA Management","RemappingSupported",0x00010001,1

DMA Management\RemappingSupported 的有效值如下:

价值 意义
0 退出。这向系统指示设备和驱动程序与 DMA 重新映射不兼容。
1 选择加入。 这向系统指示设备和驱动程序与 DMA 重新映射完全兼容。
无注册表项 让系统确定策略。

(可选)添加 RemappingFlags 以进一步控制行为:

 [DMA_Remapping_OptIn_AddReg]
 HKR,"DMA Management","RemappingSupported",0x00010001,1
 HKR,"DMA Management","RemappingFlags",0x00010001,0x00000001

DMA Management\RemappingFlags 的有效值如下:

价值 意义
0 如果 RemappingSupported 为 1,则无条件选择加入。
1 如果 RemappingSupported 为 1,则仅当满足以下一个或多个条件时才选择加入:A. 设备是外部设备(例如 Thunderbolt);B. 在驱动程序验证程序中启用了 DMA 验证。
无注册表项 与 0 值相同。

以下注册表项将显示在枚举树下:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Enum\PCI\<device instance path>\Device Parameters\DMA Management

按驱动程序选择加入机制

仅在 Windows 版本不高于 Windows 11 23H2 时使用此按驱动程序方法。 强烈建议使用上文中所述的按设备方法

将 INF 指令(如以下内容)添加到服务安装部分:

  [MyServiceInstall_AddReg]
  HKR,Parameters,DmaRemappingCompatible,0x00010001,1    ; where 1 = opt-in

DmaRemappingCompatible 的有效值为:

价值 意义
0 选择退出。这向系统指示驱动程序与 DMA 重新映射不兼容。
1 选择加入。 这向系统指示驱动程序与 DMA 重新映射完全兼容。
2 选择加入,但前提是满足以下一个或多个条件:A。如果设备是外部设备(例如Thunderbolt;B.如果在驱动程序验证器中启用了 DMA 验证。
3 选择加入
无注册表项 让系统确定策略。

测试驱动程序时,启用驱动程序验证程序。 为了在驱动程序验证程序下进行测试,用于选择外部设备的 INF 指令的值将提升为 1。

以下注册表项将显示在服务安装树下:HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\<driver name>\Parameters

警告

图形设备驱动程序不支持 DMA 重新映射。

验证是否为特定设备驱动程序实例启用了 DMA 重新映射

使用启用了 VT-d/AMD-Vi 的最新 Windows 版本在 Intel x64 和 AMD64 系统上测试驱动程序功能。

若要检查特定驱动程序是否已选择重新映射 DMA,请在设备管理器的“详细信息” 选项卡中查找与 DMA 重新映射策略属性对应的值。 驱动程序可以查询 DEVPKEY_Device_DmaRemappingPolicy 属性,以确定设备的 DMA 重新映射功能。 查看该页上的潜在返回值,并请注意,这些返回值与上一节中列出的 DmaRemappingCompatible 的值不同。

“设备管理器详细信息”选项卡。

注意

对于 Windows 10 版本 1803 和 1809,Device Manager 中的属性字段使用 GUID {83da6326-97a6-4088-9453-a1923f573b29}[18]