DXGKCB_SETPOWERCOMPONENTIDLE コールバック関数 (d3dkmddi.h)
ディスプレイ ミニポート ドライバーは 、 電源コンポーネントが不要になった DirectX グラフィックス カーネル サブシステムに通知するDXGKCB_SETPOWERCOMPONENTIDLEを呼び出します。 この関数が返された後、ディスプレイ ミニポート ドライバーは、コンポーネントのハードウェア設定を変更することはできません。
構文
DXGKCB_SETPOWERCOMPONENTIDLE DxgkcbSetpowercomponentidle;
void DxgkcbSetpowercomponentidle(
[in] IN_CONST_HANDLE hAdapter,
[in] UINT ComponentIndex
)
{...}
パラメーター
[in] hAdapter
ディスプレイ アダプターへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiStartDevice 関数の呼び出しで、DXGKRNL_INTERFACE構造体の DeviceHandle メンバーからハンドルを受け取ります。
[in] ComponentIndex
DXGKARG_QUERYADAPTERINFOで指定された電源コンポーネントインデックス。DxgkDdiQueryAdapterInfo 関数の呼び出し内の pInputData。
戻り値
なし
解説
ディスプレイ ミニポート ドライバーは、DirectX グラフィックス カーネル サブシステムがコンポーネントのアイドル状態を管理する場合でも、任意の種類の電源コンポーネントに対してこの関数を呼び出すことができます。
DXGKCB_XXX 関数は Dxgkrnl によって実装されます。 このコールバック関数を使用するには、DXGKRNL_INTERFACEを介して DxgkCbSetPowerComponentIdle を呼び出します。 この関数の各呼び出しは、 DXGKCB_SETPOWERCOMPONENTACTIVE 関数の呼び出しとペアにする必要があります。
この関数が呼び出されると、コンポーネントのアクティブな参照カウントが 1 減少します。 Power Management Framework は、参照カウントを保持し、参照カウントが 0 になった場合にのみ、コンポーネントを低い F 状態にします。
この関数は IRQL <= DISPATCH_LEVELで呼び出す必要があります。 これは、コンポーネントの種類がDXGK_POWER_COMPONENT_OTHERの場合にのみ、IRQL = DISPATCH_LEVELで呼び出すことができます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 (WDDM 1.2) |
| サポートされている最小のサーバー | Windows Server 2012 |
| 対象プラットフォーム | デスクトップ |
| Header | d3dkmddi.h (D3dkmddi.h を含む) |
| IRQL | 「解説」を参照してください。 |