D3COLD_AUX_POWER_AND_TIMING_INTERFACE 结构 (wdm.h)

项目
02/27/2024

INTERFACE 结构的扩展版本，允许设备驱动程序在处于 D3Cold 状态时为其 PCI 设备协商更高的辅助电源。此接口允许设备驱动程序调用操作_DSM函数 0Ah， 0Bh。

语法

typedef struct _D3COLD_AUX_POWER_AND_TIMING_INTERFACE {
  USHORT                          Size;
  USHORT                          Version;
  PVOID                           Context;
  PINTERFACE_REFERENCE            InterfaceReference;
  PINTERFACE_DEREFERENCE          InterfaceDereference;
  PD3COLD_REQUEST_CORE_POWER_RAIL RequestCorePowerRail;
  PD3COLD_REQUEST_AUX_POWER       RequestAuxPower;
  PD3COLD_REQUEST_PERST_DELAY     RequestPerstDelay;
} D3COLD_AUX_POWER_AND_TIMING_INTERFACE, *PD3COLD_AUX_POWER_AND_TIMING_INTERFACE;

成员

Size

此结构的大小（以字节为单位）。

Version

驱动程序定义的接口版本。此接口的当前版本D3COLD_AUX_POWER_AND_TIMING_INTERFACE_VERSION。

Context

指向特定于接口的上下文信息的指针。

InterfaceReference

指向 InterfaceReference 例程的指针，该例程递增接口的引用计数。

InterfaceDereference

指向接口引用计数递减的 InterfaceDereference 例程的指针。

RequestCorePowerRail

指向 D3COLD_REQUEST_CORE_POWER_RAIL 回调函数的指针，该函数使函数设备对象 (FDO) 指示是否需要核心电源轨。

RequestAuxPower

指向 _D3COLD_REQUEST_AUX_POWER 回调函数的指针，该函数使函数设备对象 (FDO) 传达其辅助电源要求。

RequestPerstDelay

指向 D3COLD_REQUEST_PERST_DELAY 的指针使函数设备对象 (FDO) 传达其固定延迟时间的要求。

注解

成功查询GUID_D3COLD_AUX_POWER_AND_TIMING_INTERFACE接口的设备驱动程序会收到指向 [D3COLD_AUX_POWER_AND_TIMING_INTERFACE] 结构的指针，其中指向接口中例程的指针都是非 NULL 且有效的。

[D3COLD_AUX_POWER_AND_TIMING_INTERFACE] 结构是 [INTERFACE] 结构的扩展版本。

Windows 现在添加了对新引入的 PCI 设备特定方法 (_DSM) 函数的支持，用于运行时设备电源管理。如果设备在 D3Cold 状态下需要额外的电源，则下面列出的新接口允许设备驱动程序为其 PCI 设备协商更高的辅助电源 (高于标准 375mA @ 3.3V) 。所有设备驱动程序都必须能够处理系统无法提供额外电源的情况，或者接口不受支持的情况。

支持运行时设备电源管理_DSM功能的所有 PCIe 端口都必须在 PCIe 端口的 ACPI 范围下实现设备特定数据 (_DSD) 以识别支持 D3_COLD_AUX_POWER ECN 接口的 PCIe 端口。