D3COLD_AUX_POWER_AND_TIMING_INTERFACE 構造体 (wdm.h)

[アーティクル]
08/08/2023

D3Cold 状態の間に、デバイスドライバーが PCI デバイスのより高い補助電源をネゴシエートできるようにする INTERFACE 構造体の拡張バージョン。このインターフェイスを使用すると、デバイスドライバーは、_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

関数デバイスオブジェクト (FDO) がコア電源レールが必要かどうかを示すD3COLD_REQUEST_CORE_POWER_RAILコールバック関数へのポインター。

RequestAuxPower

関数デバイスオブジェクト (FDO) が補助電源要件を伝達できるようにする、_D3COLD_REQUEST_AUX_POWER コールバック関数へのポインター。

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 スコープの下D3_COLD_AUX_POWER ECN インターフェイスをサポートする PCIe ポートを識別するために、デバイス固有のデータ (_DSD) を実装する必要があります。