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 は、 待機時間で指定された待機時間の許容範囲を満たすようにコンポーネントの F 状態を変更する可能性があります。

ドライバーが [待機時間] を 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

こちらもご覧ください

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice