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 位追蹤。

規格需求

另請參閱

DxgkDdiCreateMemoryBasis

DxgkDdiStopDirtyTracking