DXGK_DIRTY_BIT_TRACKING_CAPS structure (d3dkmddi.h)

A kernel-mode display miniport driver (KMD) returns its dirty bit tracking capabilities in DXGK_DIRTY_BIT_TRACKING_CAPS when its DxgkDdiQueryAdapterInfo function is called with the DXGKQAITYPE_DIRTYBITTRACKINGCAPS query adapter info type.

Syntax

typedef struct _DXGK_DIRTY_BIT_TRACKING_CAPS {
  union {
    struct {
      UINT32 DirtyBitTrackingSupported : 1;
      UINT32 DirtyBitTrackingPerformant : 1;
      UINT32 Reserved : 30;
    };
    UINT32 Value;
  };
} DXGK_DIRTY_BIT_TRACKING_CAPS;

Members

DirtyBitTrackingSupported

When set TRUE, the adapter supports the ability to track dirty bit information. Dxgkrnl will, at a later time, call the followup DXGKQAITYPE_DIRTYBITTRACKINGSEGMENTCAPS call for each segment to determine the page size/granularity at which the data is tracked.

DirtyBitTrackingPerformant

When set TRUE, the adapter is reporting the preference to track dirty content from the creation of the vDEV. This capability can drastically improve the performance of live migration scenarios by allowing only dirty content inside VRAM reserve to be transferred. If DirtyBitTrackingPerformant is FALSE, dirty tracking is only enabled during the live migration itself, and the initial transfer of content will be the entire reserved VRAM for the VF being migrated.

Reserved

Reserved for system use.

Value

An alternative way to access the structure's bitfields.

Remarks

For more information, see Dirty Bit Tracking.

Requirements

Requirement Value
Minimum supported client Windows 11, version 24H2
Header d3dkmddi.h

See also

DXGK_QUERYADAPTERINFOTYPE

DxgkDdiQueryAdapterInfo