共用方式為


DXGKDDI_STARTDIRTYTRACKING回呼函式 (d3dkmddi.h)

KMD 的 DxgkDdiStartDirtyTracking 函式可在指定的區段和指定的位址範圍內啟用髒位追蹤。

語法

DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;

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

參數

hAdapter

[in]與顯示配接器相關聯的內容區塊句柄。 KMD 先前在 DxgiDdiAddDevice 函式的 MiniportDeviceContext 輸出參數中,提供此句柄來 Dxgkrnl

hMemoryBasis

[in]處理要開始追蹤髒作業的記憶體基礎。 KMD 在先前呼叫 dxgkDdiCreateMemoryBasis 中建立了此句柄。

傳回值

DxgkDdiStartDirtyTracking 會在成功時傳回STATUS_SUCCESS。 否則,它會傳回適當的NTSTATUS程式代碼。

言論

驅動程式只需要確保已針對指定的記憶體基礎啟用髒追蹤。 不過,只要遵守所有未處理的要求,以較粗略的數據粒度執行這項作(例如,針對整個配接器或區段啟用髒追蹤)都是有效的。

Dxgkrnl 可能會同時在這些區段內的多個區段或範圍上啟用髒頁面追蹤。

啟用骯髒追蹤時,Dxgkrnl 預期會將骯髒的位平面初始化為所有零(未修改的所有頁面)。

如需詳細資訊,請參閱 Dirty 位追蹤

要求

要求 價值
最低支援的用戶端 Windows 11 版本 24H2 (WDDM 3.2)
標頭 d3dkmddi.h
IRQL PASSIVE_LEVEL

另請參閱

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking