DXGKCB_SETPOWERCOMPONENTACTIVE コールバック関数 (d3dkmddi.h)

[アーティクル]
02/26/2024

ディスプレイミニポートドライバーは、電源コンポーネントにアクセスするために DXGKCB_SETPOWERCOMPONENTACTIVE を呼び出します。この関数が返された後、ディスプレイミニポートドライバーは、コンポーネントのハードウェア設定を変更できます。

構文

DXGKCB_SETPOWERCOMPONENTACTIVE DxgkcbSetpowercomponentactive;

void DxgkcbSetpowercomponentactive(
  [in] IN_CONST_HANDLE hAdapter,
  [in] UINT ComponentIndex
)
{...}

パラメーター

[in] hAdapter

ディスプレイアダプターへのハンドル。ディスプレイミニポートドライバーは、DxgkDdiStartDevice 関数の呼び出しで、DXGKRNL_INTERFACE構造体の DeviceHandle メンバーからハンドルを受け取ります。

[in] ComponentIndex

DXGKARG_QUERYADAPTERINFOで指定された電源コンポーネントインデックス。DxgkDdiQueryAdapterInfo 関数の呼び出し内の pInputData。

戻り値

なし

解説

この関数の各呼び出しは、コンポーネントハードウェアが不要であることを示すために 、DXGKCB_SETPOWERCOMPONENTIDLE 関数の呼び出しとペアになっている必要があります。

この関数が呼び出されると、コンポーネントのアクティブな参照カウントが 1 増加します。 Power Management Framework は参照カウントを保持し、参照カウントが 0 になった場合にのみ、コンポーネントを低い F 状態にします。

この関数の呼び出し中に、ディスプレイミニポートドライバーは、別の実行スレッドで DxgkDdiSetPowerComponentFState 関数の呼び出しを受け取る可能性があります。

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

要件

要件	値
サポートされている最小のクライアント	Windows 8 (WDDM 1.2)
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	デスクトップ
Header	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	PASSIVE_LEVEL