DXGKCB_INVALIDATEHWCONTEXT コールバック関数 (d3dkmddi.h)
カーネル モード グラフィックス ドライバー (KMD) は、ハードウェア コンテキスト 無効にするために DxgkcbInvalidatehwcontext を呼び出します。
構文
DXGKCB_INVALIDATEHWCONTEXT DxgkcbInvalidatehwcontext;
NTSTATUS DxgkcbInvalidatehwcontext(
[in] IN_CONST_PDXGKARGCB_INVALIDATEHWCONTEXT unnamedParam1
)
{...}
パラメーター
[in] unnamedParam1
ハードウェア コンテキストの無効化に使用 Dxgkrnl の情報を含む DXGKARGCB_INVALIDATEHWCONTEXT 構造体へのポインター。
戻り値
DxgkcbInvalidatehwcontext 、操作が成功した場合にSTATUS_SUCCESSを返します。 それ以外の場合は、適切な NTSTATUS エラー コードが返されます。
備考
KMD は DxgkcbInvalidatehwcontext 呼び出して、ハードウェア コンテキストに関連付けられている状態とリソースが無効または一貫性がなくなった場合にシステムに通知するため、コンテキストをリセットまたは再初期化してから再度使用する必要があります。 障害からの復旧や GPU リソースの再構成など、さまざまな理由でハードウェア エンジンのリセット操作が発生した場合は、コンテキストを無効にする必要があります。
Dxgkrnl は、GPU での実行がスケジュールされなくなっているように、コンテキストを無効としてマークします。 その後、コンテキストに関連付けられているリソースの解放や、コンテキストに関連付けられている状態のリセットなど、必要なクリーンアップが開始されます。
DXGKCB_XXX 関数は、Dxgkrnlによって実装されます。 このコールバック関数を使用するには、DXGKARGCB_INVALIDATEHWCONTEXT のメンバーを設定し、DXGKRNL_INTERFACEを介して DxgkCbInvalidateHwContext 呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 10 バージョン 1703 (WDDM 2.2) |
| ヘッダー | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |