DXGKDDI_STARTDIRTYTRACKING - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// d3dkmddi.h
DXGKDDI_STARTDIRTYTRACKING DxgkddiStartdirtytracking;
NTSTATUS DxgkddiStartdirtytracking(
IN_CONST_HANDLE hAdapter,
IN_CONST_HANDLE hMemoryBasis
)
{...}
View the official Windows Driver Kit DDI referenceNo description available.
KMD's DxgkDdiStartDirtyTracking function enables dirty bit tracking within the specified segment and given address range.
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 start tracking dirty operations. KMD created this handle in a previous call to DxgkDdiCreateMemoryBasis.
DxgkDdiStartDirtyTracking returns STATUS_SUCCESS upon success. Otherwise, it returns an appropriate NTSTATUS code.
The driver only needs to ensure that dirty tracking is enabled for the specified memory basis. However, doing so at a coarser granularity (for example, enabling dirty tracking for the entire adapter or segment) is valid as long as all outstanding requests are honored.
Dxgkrnl might enable dirty page tracking on multiple segments or ranges within those segments simultaneously.
When dirty tracking is enabled, Dxgkrnl expects the dirty bitplane to be initialized to all zeroes (all pages unmodified).
For more information, see Dirty bit tracking.