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

KMD の DxgkDdiStartDirtyTracking 関数を使用すると、指定したセグメントおよび指定されたアドレス範囲内でダーティ ビット追跡を実行できます。

構文

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

NTSTATUS DxgkddiStartdirtytracking(
  IN_CONST_HANDLE hAdapter,
  IN_CONST_HANDLE hMemoryBasis
)
{...}

パラメーター

hAdapter

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

hMemoryBasis

[in]ダーティ操作の追跡を開始するメモリベースを処理します。 KMD は、DxgkDdiCreateMemoryBasisをする前の呼び出しでこのハンドルを作成しました。

戻り値

DxgkDdiStartDirtyTracking 成功するとSTATUS_SUCCESSが返されます。 それ以外の場合は、適切な NTSTATUS コードが返されます。

備考

ドライバーは、指定されたメモリベースでダーティ 追跡が有効になっていることを確認する必要があります。 ただし、すべての未処理の要求が受け入れられている限り、より粗い粒度 (アダプターまたはセグメント全体のダーティ追跡を有効にするなど) で行うことは有効です。

Dxgkrnl 、それらのセグメント内の複数のセグメントまたは範囲内でダーティ ページ追跡を同時に有効にすることができます。

ダーティ トラッキングが有効になっている場合、dxgkrnl はダーティ ビットプレーンがすべてのゼロ (変更されていないすべてのページ) に初期化されることを想定します。

詳細については、「ダーティ ビットトラッキング を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	Windows 11 バージョン 24H2 (WDDM 3.2)
ヘッダー	d3dkmddi.h
IRQL	PASSIVE_LEVEL

関連項目

DxgkDdiCreateMemoryBasisの

DxgkDdiStopDirtyTracking