DXGKCB_SETPOWERCOMPONENTRESIDENCY コールバック関数 (d3dkmddi.h)
カーネル モードディスプレイ ミニポート ドライバーは 、DXGKCB_SETPOWERCOMPONENTRESIDENCY を呼び出して、 DXGK_POWER_COMPONENT_OTHER型の電源コンポーネントの想定される所在地を設定します。
構文
DXGKCB_SETPOWERCOMPONENTRESIDENCY DxgkcbSetpowercomponentresidency;
void DxgkcbSetpowercomponentresidency(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex,
[in] ULONGLONG Residency
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiStartDevice 関数の呼び出しで、DXGKRNL_INTERFACE構造体の DeviceHandle メンバーからハンドルを受け取ります。
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFOで指定された電源コンポーネントインデックス。DxgkDdiQueryAdapterInfo 関数の呼び出し内の pInputData。
[in] Residency
ディスプレイ ミニポート ドライバーが電源コンポーネントがアイドル状態に入った後もアイドル状態を維持すると予想される、予想される常駐時間 (最大時間は 100 ナノ秒単位)。 Power Management Framework はこの情報を使用して、要求された所在地に違反しないコンポーネントの適切なアイドル状態を選択します。 Residency で指定された予想される所在地は、ドライバーがこの関数を再度呼び出して更新するまで有効です。 「解説」を参照してください。
戻り値
なし
解説
注意
ディスプレイ ミニポート ドライバーは、コンポーネントの種類が DXGK_POWER_COMPONENT_OTHER場合にのみ、この関数を呼び出す必要があります。 DirectX グラフィックス カーネル サブシステムは、他のコンポーネントの種類に対して想定される常駐値を設定します。
DXGKCB_XXX 関数は Dxgkrnl によって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACEを介して DxgkCbSetPowerComponentResidency を呼び出します。
この関数の呼び出し時に電源コンポーネントがアイドル状態の場合、 Power Management Framework は、コンポーネントの F 状態を、 Residency で指定された予想される所在地値を満たすように変更する可能性があります。
ドライバーが 常駐 を PO_FX_UNKNOWN_TIME ( Wdm.h で定義) の値に設定した場合、Power Engine プラグイン (PEP) は、コンポーネントを F0 より小さい F 状態に設定できない可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 (WDDM 1.2) |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | <= DISPATCH_LEVEL |