次の方法で共有

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

  • [アーティクル]

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

構文

DXGKDDI_CANCELCOMMAND DxgkddiCancelcommand;

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

パラメーター

hAdapter

ディスプレイ アダプターに関連付けられているコンテキスト ブロックへのハンドル。 ディスプレイ ミニポート ドライバーは、DxgkDdiAddDevice 関数の出力パラメーター ミニポートDeviceContext の 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
ターゲット プラットフォーム の デスクトップ
ヘッダー d3dkmddi.h
IRQL PASSIVE_LEVEL

関連項目

DXGKARG_CANCELCOMMAND

DXGK_VIDSCHCAPS

DxgkDdiAddDevice の