次の方法で共有


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 を呼び出します。SupportRuntimePowerManagementTRUE する

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

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

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

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

必要条件

要件 価値
サポートされる最小クライアント Windows 8
サポートされる最小サーバー Windows Server 2012
ターゲット プラットフォーム デスクトップ
ヘッダー d3dkmddi.h
IRQL <=DISPATCH_LEVEL

関連項目

DXGKARG_QUERYADAPTERINFO

DXGKRNL_INTERFACE

DXGK_DRIVERCAPS

DxgkCbSetPowerComponentActive

DxgkDdiAddDevice

DxgkDdiQueryAdapterInfo