DXGKCB_SETPOWERCOMPONENTLATENCY コールバック関数 (d3dkmddi.h)
ディスプレイ ミニポート ドライバーは、DXGKCB_SETPOWERCOMPONENTLATENCY を呼び出して、DXGK_POWER_COMPONENT_OTHER型の電源コンポーネントの待機時間の許容範囲を設定します。
構文
DXGKCB_SETPOWERCOMPONENTLATENCY DxgkcbSetpowercomponentlatency;
void DxgkcbSetpowercomponentlatency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Latency
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiStartDevice 関数の呼び出しで、DXGKRNL_INTERFACE 構造体の DeviceHandle メンバーからハンドルを受け取ります。
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFOで指定された電源コンポーネントのインデックス。DxgkDdiQueryAdapterInfo 関数の呼び出しで pInputDataを します。
[in] Latency
ディスプレイ ミニポート ドライバーがアイドル状態から電源コンポーネントを目覚めさせるために実行する必要がある、待機時間許容 (最大時間 (100 ナノ秒単位)。 Power Management Framework では、この情報を使用して、要求された待機時間の許容範囲に違反しないコンポーネントの適切なアイドル状態を選択します。 待機時間 で指定された待機時間の許容範囲は、ドライバーがこの関数を再度呼び出して更新するまで有効です。 「解説」を参照してください。
戻り値
何一つ
備考
手記
ディスプレイ ミニポート ドライバーは、コンポーネントの種類が DXGK_POWER_COMPONENT_OTHER場合にのみ、この関数を呼び出す必要があります。 DirectX グラフィックス カーネル サブシステムは、他のコンポーネントの種類の待機時間の許容値を設定します。
DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACE経由で DxgkCbSetPowerComponentLatency を呼び出します。
この関数の呼び出し時に電源コンポーネントがアイドル状態の場合、Power Management Framework は、Latencyで指定された待機時間の許容範囲を満たすようにコンポーネントの F 状態を変更する可能性があります。
ドライバーが 待機時間 を PO_FX_UNKNOWN_TIME (Wdm.hで定義) の値に設定すると、Power Engine プラグイン (PEP) は、コンポーネントを F0 より小さい F 状態に設定できない可能性があります。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 8 (WDDM 1.2) |
| サポートされる最小サーバー | Windows Server 2012 |
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | <= DISPATCH_LEVEL |
関連項目
DxgkDdiQueryAdapterInfoの
DxgkDdiStartDeviceの