Edit

DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_HISTOGRAM structure (dispmprt.h)

  • Article

The DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_HISTOGRAM structure provides histogram information for the current buffer being scanned out during diagnostic data collection.

Syntax

typedef struct _DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_HISTOGRAM {
  INT MinPixelValue;
  INT MaxPixelValue;
} DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_HISTOGRAM;

Members

MinPixelValue

Minimum pixel value in the histogram for the currently scanned out buffer. A value of -1 specifies that no histograms are supported.

MaxPixelValue

Maximum pixel value in the histogram for the currently scanned out buffer.

Remarks

DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_HISTOGRAM is a member of the DXGK_DIAG_SCANOUT_BUFFER_CONTENT structure, which is passed as a member of the DXGK_DISPLAYSTATE_INTRUSIVE structure in calls to DxgkDdiGetDisplayStateIntrusive during diagnostic data collection.

If the hardware doesn't support CRC calculation on the scanned out pixels and the driver/hardware maintains a histogram of the buffers being scanned out then it should return MinPixelValue and MaxPixelValue for the current buffer being scanned out. These values should be on the final scanned out pixels including all gamma and any other transformation applied. Since the minimum and maximum values will depend on the gamma values, and the operating system might not know the whole gamma curve being applied, the OS will only use these values for an overall decision of whether the pixels might be black or near black.

Requirements

Requirement Value
Minimum supported client Windows 10, version 2004
Header dispmprt.h

See also

DXGK_DIAG_SCANOUT_BUFFER_CONTENT

DXGK_DIAG_DISPLAY_SCANOUT_BUFFER_CRC

DXGK_DISPLAYSTATE_INTRUSIVE

DXGKARG_GETDISPLAYSTATEINTRUSIVE

DxgkDdiGetDisplayStateIntrusive