DXGKCB_SETPOWERCOMPONENTACTIVE コールバック関数 (d3dkmddi.h)
ディスプレイ ミニポート ドライバーは、電源コンポーネントにアクセスするために 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 |