Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
DXGK_DIAG_GETDISPLAYSTATE_SUBSTATUS_FLAGS specifies the substatus for per target diagnostic data collection.
Syntax
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;
Constants
DXGK_DIAG_GETDISPLAYSTATE_SUCCESSNo errors occurred on the given vidpntarget while collecting the diagnostic information. |
DXGK_DIAG_GETDISPLAYSTATE_CAUSED_GLITCHA user-visible glitch occurred on a given vidpntarget while collecting the diagnostic information. |
DXGK_DIAG_GETDISPLAYSTATE_CHANGED_DISPLAY_STATEA display state change (hardware or software) was caused while collecting the diagnostic information on the given vidpntarget. |
DXGK_DIAG_GETDISPLAYSTATE_MONITOR_NOT_CONNECTEDNo monitor was detected as connected on the given vidpntarget. |
DXGK_DIAG_GETDISPLAYSTATE_TIMEOUTThe driver hit a timeout while collecting the diagnostic information on a given vidpntarget. |
DXGK_DIAG_GETDISPLAYSTATE_ERROR_HARDWAREThe driver hit a hardware error while collecting the diagnostic information on a given vidpntarget. |
DXGK_DIAG_GETDISPLAYSTATE_ERROR_DRIVERThe driver hit a software error while collecting the diagnostic information on a given vidpntarget. |
DXGK_DIAG_GETDISPLAYSTATE_VIDPNTARGETID_NOT_FOUNDThe 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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows 10, version 2004 |
| Header | dispmprt.h |
See also
DXGK_DISPLAYSTATE_NONINTRUSIVE