次の方法で共有

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 は、この情報を使用して、要求された常駐に違反しないコンポーネントの適切なアイドル状態を選択します。 常駐 で指定された想定される常駐は、ドライバーがこの関数を再度呼び出して更新するまで有効です。 「解説」を参照してください。

戻り値

何一つ

備考

手記

ディスプレイ ミニポート ドライバーは、コンポーネントの種類が DXGK_POWER_COMPONENT_OTHER場合にのみ、この関数を呼び出す必要があります。 DirectX グラフィックス カーネル サブシステムは、他のコンポーネントの種類に対して想定される常駐値を設定します。

DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACE使用して DxgkCbSetPowerComponentResidency を呼び出します。

この関数の呼び出し時に電源コンポーネントがアイドル状態の場合、Power Management Framework は、常駐で指定された予想される常駐値を満たすようにコンポーネントの 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

関連項目

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfoの

DxgkDdiStartDeviceの