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

ディスプレイ ポート ドライバーの GPU スケジューラは、ミニポート ドライバー (KMD) DxgkDdiResetEngine 関数を呼び出して、スケジューラがアダプターのタイムアウト状態を検出したときに物理ディスプレイ アダプターのアクティブ ノードをリセットします。

構文

DXGKDDI_RESETENGINE DxgkddiResetengine;

NTSTATUS DxgkddiResetengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESETENGINE pResetEngine
)
{...}

パラメーター

hAdapter

[入力]ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 KMD は以前、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで Dxgkrnl にこのハンドルを提供していました。

pResetEngine

[入力/出力]リセットするノードを指定し、最後に中止されたパケットのフェンス識別子を提供するDXGKARG_RESETENGINE構造体。

戻り値

DxgkDdiResetEngine は 、関数が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合、この関数は Ntstatus.h で定義されているエラー コードの 1 つを返します。

注釈

KMD は、次のすべての条件が満たされた場合にのみ、この関数の呼び出しから返す必要があります。

• リセット操作が完了しました。
• 物理アダプターのハードウェア キューには何も残っていない。
• 指定されたノードは、新しいパケットを受け入れる準備ができています。

この関数はページング可能にする必要があります。

オペレーティング システムは、この関数が 第 1 レベルの同期モードに従っていることを保証します。

詳細については、「Windows 8での TDR の変更」を参照してください。

要件

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

こちらもご覧ください

DXGKARG_RESETENGINE

DxgkDdiAddDevice