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 |