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 |