DXGKDDI_STOPDIRTYTRACKING callback function (d3dkmddi.h)

Article
05/22/2024

KMD's DxgkDdiStopDirtyTracking function disables dirty bit tracking within the specified segment and given address range.

Syntax

DXGKDDI_STOPDIRTYTRACKING DxgkddiStopdirtytracking;

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

Parameters

hAdapter

[in] A handle to a context block associated with a display adapter. KMD previously provided this handle to Dxgkrnl in the MiniportDeviceContext output parameter of the DxgiDdiAddDevice function.

hMemoryBasis

[in] Handle to the memory basis over which to stop tracking dirty operations. KMD created this handle in a previous call to DxgkDdiCreateMemoryBasis.

Return value

DxgkDdiStopDirtyTracking returns STATUS_SUCCESS upon success. Otherwise, it returns an appropriate NTSTATUS code.

Remarks

The driver should ensure that all previous start requests are still honored. For example, if KMD only supports dirty tracking on the entire segment at once and there are two outstanding requests for dirty tracking, stopping only one request should keep dirty bit tracking enabled for the other request.

The driver can be guaranteed that a call to DxgkDdiStopDirtyTracking will specify the same ranges of memory as the corresponding DxgkDdiStartDirtyTracking calls. For example, if Dxgkrnl made a call to start dirty tracking on [0, 1GB) of segment 1, there will eventually be a resulting call to stop dirty tracking on the segment [0, 1GB) range in segment 1.

For more information, see Dirty bit tracking.

Requirements

Requirement	Value
Minimum supported client	Windows 11, version 24H2 (WDDM 3.2)
Header	d3dkmddi.h
IRQL	PASSIVE_LEVEL

Share via