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) 运行时间装置电源管理的函式支援。下列新介面可讓設備驅動器為其PCI裝置交涉較高的輔助電源， (高於標準375mA @ 3.3V) ，如果裝置在 D3Cold 狀態時需要額外的電源。所有設備驅動器都必須能夠處理系統無法提供額外電源的情況，如果不支援介面，則為。

支援運行時間裝置電源管理_DSM功能的所有PCIe埠，都必須實作裝置特定資料 (_DSD) ，以識別支援D3_COLD_AUX_POWER PCIe埠之ACPI範圍下之ECN介面的PCIe 埠。