DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers
// dispmprt.h

typedef enum _DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS {
  DXGK_DIAG_GETDISPLAYSTATE_SUCCESS,
  DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH,
  DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE,
  DXGK_DIAG_GETDISPLAYSTATE_MONITOR_NOT_CONNECTED,
  DXGK_DIAG_GETDISPLAYSTATE_TIMEOUT,
  DXGK_DIAG_GETDISPLAYSTATE_ERROR_HARDWARE,
  DXGK_DIAG_GETDISPLAYSTATE_ERROR_DRIVER,
  DXGK_DIAG_GETDISPLAYSTATE_VIDPNTARGETID_NOT_FOUND
} DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS;
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Windows Driver Kit DDI reference (ne-dispmprt-dxgk_diag_getdisplaystate_substatus_flags)

DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS enumeration

Description

DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS specifies the substatus for per target diagnostic data collection.

Constants

DXGK_DIAG_GETDISPLAYSTATE_SUCCESS

No errors occurred on the given vidpntarget while collecting the diagnostic information.

DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH

A user-visible glitch occurred on a given vidpntarget while collecting the diagnostic information.

DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE

A display state change (hardware or software) was caused while collecting the diagnostic information on the given vidpntarget.

DXGK_DIAG_GETDISPLAYSTATE_MONITOR_NOT_CONNECTED

No monitor was detected as connected on the given vidpntarget.

DXGK_DIAG_GETDISPLAYSTATE_TIMEOUT

The driver hit a timeout while collecting the diagnostic information on a given vidpntarget.

DXGK_DIAG_GETDISPLAYSTATE_ERROR_HARDWARE

The driver hit a hardware error while collecting the diagnostic information on a given vidpntarget.

DXGK_DIAG_GETDISPLAYSTATE_ERROR_DRIVER

The driver hit a software error while collecting the diagnostic information on a given vidpntarget.

DXGK_DIAG_GETDISPLAYSTATE_VIDPNTARGETID_NOT_FOUND

The driver did not find the VidPnTargetId provided by the OS in the DDI call.

Remarks

The DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS enumeration is a member of the DXGK_DISPLAYSTATE_NONINTRUSIVE structure. It is used while gathering display diagnostic information via calls to DxgkDdiGetDisplayStateNonIntrusive.

In rare cases where a platform-specific implementation requires the driver to carry out intrusive operations during a call to DxgkDdiGetDisplayStateNonIntrusive, the driver should carry out these operations but must set DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS to DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCH or DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATE accordingly. The OS can use this information to decide whether to call the DDI for error scenarios only on a given system.

The substatus information helps the driver succeed the overall DxgkDdiGetDisplayStateNonIntrusive call even if there were failure or errors on some of the targets.

See also

DXGK_DISPLAYSTATE_NONINTRUSIVE

DXGKARG_GETDISPLAYSTATENONINTRUSIVE

DxgkDdiGetDisplayStateNonIntrusive