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

電源コンポーネントをアイドル状態 (F 状態) に移行するために、Microsoft DirectX グラフィックス カーネル サブシステムによって呼び出されます。

構文

DXGKDDISETPOWERCOMPONENTFSTATE Dxgkddisetpowercomponentfstate;

NTSTATUS Dxgkddisetpowercomponentfstate(
  IN_CONST_HANDLE DriverContext,
  UINT ComponentIndex,
  UINT FState
)
{...}

パラメーター

DriverContext

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーの DxgkDdiAddDevice 関数は、以前は DirectX グラフィックス カーネル サブシステムにこのハンドルを提供しました。

ComponentIndex

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

FState

ディスプレイ ミニポート ドライバーが DirectX グラフィックス カーネル サブシステムに報告した F 状態の値。

戻り値

成功した場合はSTATUS_SUCCESSを返します。それ以外の場合は、STATUS_INVALID_PARAMETERを返します。

注釈

オペレーティング システムは、ディスプレイ ミニポート ドライバーがDXGK_DRIVERCAPSを設定してサポートを示す場合にのみ DxgkDdiSetPowerComponentFState呼び出します。SupportRuntimePowerManagement から TRUE

メモ デッドロックの可能性を回避するには、この関数が返されるまで DxgkCbSetPowerComponentActive 関数を呼び出さないでください。
 
ディスプレイ ミニポート ドライバーは、電源コンポーネントを F0 (完全にオン) 状態から別の F 状態に切り替えると、後でコンポーネントを F0 状態に戻すために必要なコンテキストを保存する必要があります。

Power Management Framework は、コンポーネントを F0 状態に切り替えるだけです。

この関数は、複数の実行スレッドから同時に呼び出すことができます。 ただし、この関数を呼び出して特定のコンポーネントを制御できるのは、一度に 1 つのスレッドだけです。

オペレーティング システムは、この関数がスレッド処理と同期ゼロ レベルで定義されているゼロ レベル の同期モードに従っていることを保証します。

要件

要件
サポートされている最小のクライアント Windows 8
サポートされている最小のサーバー Windows Server 2012
対象プラットフォーム デスクトップ
Header d3dkmddi.h
IRQL <=DISPATCH_LEVEL

こちらもご覧ください

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo