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

  • [アーティクル]

Dxgkrnl は、GPU エンジンが正常にリセットされた後に DxgkDdiResumeHwEngine を呼び出して、 リセット によって無効になっていないコンテキストを再送信するように GPU スケジューラに指示します。

構文

DXGKDDI_RESUMEHWENGINE DxgkddiResumehwengine;

NTSTATUS DxgkddiResumehwengine(
  IN_CONST_HANDLE hAdapter,
  INOUT_PDXGKARG_RESUMEHWENGINE pResumeHwEngine
)
{...}

パラメーター

hAdapter

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

pResumeHwEngine

[入力/出力]ハードウェア エンジンを再開するための情報を含む DXGKARG_RESUMEHWENGINE 構造体へのポインター。

戻り値

操作が成功した場合、DxgkDdiResumeHwEngine はSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードを返す必要があります。 呼び出しが失敗した場合、OS は完全な GPU リセットを実行します。

注釈

DxgkDdiResetHwEngine が呼び出された後、エンジンはまだ再開されたとは見なされないため、無効にされなかったコンテキストも送信できません。 OS では、このエンジンからの割り込みを再度有効にし、その状態をリセット GPU エンジンと同期する必要があります。 その後、OS は割り込みを有効にし、 DxgkDdiResumeHwEngine を呼び出します。これにより、エンジンのリセットの影響を受けなかったすべての実行可能なコンテキストのスケジュールを開始するように GPU エンジンに指示されます。

このコールバック関数の実装を **DRIVER_INITIALIZATION_DATA ** 構造体に 登録します。

要件

要件 値
サポートされている最小のクライアント Windows 10 バージョン 1703 (WDDM 2.2)
Header d3dkmddi.h

こちらもご覧ください

DXGKARG_RESUMEHWENGINE

DxgkDdiResetHwEngine