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 は、参照カウントを保持し、参照カウントがゼロになった場合にのみ、コンポーネントを低い F 状態に配置します。

この関数は IRQL <= DISPATCH_LEVELで呼び出す必要があります。 IRQL = DISPATCH_LEVELで呼び出すことができるのは、コンポーネントの種類が DXGK_POWER_COMPONENT_OTHER場合のみです。

必要条件

要件	価値
サポートされる最小クライアント	Windows 8 (WDDM 1.2)
サポートされる最小サーバー	Windows Server 2012
ターゲット プラットフォーム の	デスクトップ
ヘッダー	d3dkmddi.h (D3dkmddi.h を含む)
IRQL	「解説」セクションを参照してください。

関連項目

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfoの

DxgkDdiStartDeviceの