次の方法で共有

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

  • [アーティクル]

GPU スケジューラのソフトウェア キュー内にあったが、デバイスがエラー状態になったためにハードウェア キューに到達しなかったダイレクト メモリ アクセス (DMA) パケットに関連付けられている内部リソースをクリーンアップします。 このようなエラー状態は、通常、 タイムアウト検出と回復 (TDR) イベントによって発生します。

構文

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

NTSTATUS DxgkddiCancelcommand(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_PDXGKARG_CANCELCOMMAND pCancelCommand
)
{...}

パラメーター

hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiAddDevice 関数の MiniportDeviceContext 出力パラメーターで DirectX グラフィックス カーネル サブシステムにこのハンドルを以前に提供しました。

pCancelCommand

コマンド がハードウェア キューから削除された後にクリーンアップするリソースを指定するDXGKARG_CANCELCOMMAND構造体へのポインター。

戻り値

正常 に完了したときにSTATUS_SUCCESS を返します。 ドライバーが代わりにエラー コードを返す場合、オペレーティング システムによってシステムのバグチェックが発生します。 詳細については、「解説」を参照してください。

注釈

メモ DirectX グラフィックス カーネル サブシステムは、 DXGK_VIDSCHCAPS場合にのみこの関数を呼び出します。CancelCommandAware メンバーが設定されています。
 
ドライバーからエラー コードが返された場合、DirectX グラフィックス カーネル サブシステムによってシステム バグチェックが発生します。 クラッシュ ダンプ ファイルでは、エラーは、次の 4 つのパラメーターを持つ BugCheck 0x119というメッセージによって示されます。
  1. 0x9
  2. 失敗したドライバー呼び出しから返された NTSTATUS エラー コード
  3. DXGKARG_CANCELCOMMAND構造体へのポインター
  4. 内部スケジューラ データ構造へのポインター

要件

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

こちらもご覧ください

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice