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 「解説」を参照してください。

こちらもご覧ください

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGKCB_SETPOWERCOMPONENTACTIVE

DxgkDdiQueryAdapterInfo

DxgkDdiStartDevice