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

[アーティクル]
08/07/2023

電源コンポーネントをアイドル状態 (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