D3COLD_AUX_POWER_AND_TIMING_INTERFACE 结构 (wdm.h)
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 端口。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 10 版本 1803 |
标头 | wdm.h |