DXGKDDI_STOPDIRTYTRACKING回呼函式 (d3dkmddi.h)

KMD 的 DxgkDdiStopDirtyTracking 函 式會停用指定區段和指定位址範圍內的中途位追蹤。

語法

DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;

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

參數

hAdapter

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

hMemoryBasis

[in]處理要停止追蹤中途作業的記憶體基礎。 KMD 會在先前呼叫 DxgkDdiCreateMemoryBasis 中建立此句柄。

傳回值

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

備註

驅動程式應該確保仍會接受所有先前的啟動要求。 例如，如果 KMD 一次只支援整個區段的中途追蹤，而且有兩個未處理的要求進行中途追蹤，則只停止一個要求應該讓另一個要求啟用中途位追蹤。

驅動程序保證呼叫 DxgkDdiStopDirtyTracking 會指定與對應 DxgkDdiStartDirtyTracking 呼叫相同的記憶體範圍。 例如，如果 Dxgkrnl 在區段 1 的 [0， 1GB) 上開始變更追蹤的呼叫，最終會產生呼叫來停止區段 [0， 1GB) 區段範圍中的變更追蹤。

如需詳細資訊，請參閱 中途位追蹤。

規格需求

另請參閱

DxgkDdiCreateMemoryBasis

DxgkDdiStartDirtyTracking