PDXGK_FSTATE_NOTIFICATION コールバック関数 (d3dkmthk.h)

状態通知を発行するためにクライアント ドライバーによって実装されます。

構文

PDXGK_FSTATE_NOTIFICATION PdxgkFstateNotification;

void PdxgkFstateNotification(
  PVOID GraphicsDeviceHandle,
  ULONG ComponentIndex,
  UINT NewFState,
  BOOLEAN PreNotification,
  PVOID PrivateHandle
)
{...}

パラメーター

GraphicsDeviceHandle

グラフィックス デバイスへのコールバックを行うときに指定する必要がある不透明なハンドル。

ComponentIndex

コンポーネントのインデックス。 一般に、これはグラフィックス アダプターで使用されるインデックスになります。 例外は、LDA シナリオでは、グラフィックス ドライバーが LDA シナリオでの F 状態の変更のためにグラフィックス カーネルによって呼び出されるときに行われるように、ComponentIndex の HIWORD がアダプター インデックスを示す LDA シナリオの場合です。

NewFState

遷移先の F 状態。

PreNotification

通知を提供する必要があることを示します。

PrivateHandle

コールバックで提供される不透明なハンドル。 このハンドルはグローバルに一意である必要があるため、呼び出し元ドライバーの PDO または FDO へのポインターを使用する必要があります。

戻り値

なし

解説

Dxgkrnl からこのコールバックに対するすべてのコールバックは、最大DISPATCH_LEVELで呼び出される場合があります (たとえば、グラフィックス以外のドライバーは、これらの通知をブロックしないでください)。 コールバックは、 DXGK_POWER_COMPONENT_SHARED タイプの電源コンポーネントに対してのみ行われます。

事前通知は、F 状態を移行する前に提供されます。 完了通知コールバック (PreNotification==FALSE) は、グラフィックス ドライバーの DxgkCbCompleteFStateTransition コールバックの一部として発行されます。 つまり、DxgkCbCompleteFStateTransition が返される前に、すべての共有電源コンポーネントに F 状態遷移の完了が通知されます。

要件

要件	値
サポートされている最小のクライアント	Windows 8
サポートされている最小のサーバー	Windows Server 2012
Header	d3dkmthk.h
IRQL	<= DISPATCH_LEVEL