DXGK_DIAG_MONITOR_STATE - NtDoc

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

typedef enum _DXGK_DIAG_MONITOR_STATE {
  DXGK_DIAG_MONITOR_STATE_UNINITIALIZED,
  DXGK_DIAG_MONITOR_READY,
  DXGK_DIAG_MONITOR_NOT_READY,
  DXGK_DIAG_MONITOR_READY_NOTAPPLICABLE
} DXGK_DIAG_MONITOR_STATE;
View the official Windows Driver Kit DDI reference

NtDoc

No description available.

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

DXGK_DIAG_MONITOR_STATE enumeration

Description

DXGK_DIAG_MONITOR_STATE specifies the state of the monitors according to the miniport driver, indicating to the operating system (OS) whether the monitors are ready to receive the pixels.

Constants

DXGK_DIAG_MONITOR_STATE_UNINITIALIZED

Reserved for OS use during diagnostic initialization.

DXGK_DIAG_MONITOR_READY

The monitor is initialized and setup, and is ready to receive pixels.

DXGK_DIAG_MONITOR_NOT_READY

The monitor is not initialized or setup correctly, and is not ready to receive pixels.

DXGK_DIAG_MONITOR_READY_NOTAPPLICABLE

The driver doesn't know the current state of the monitor. This value should be used only for monitors for which the driver has no insight into monitor state.

Remarks

The DXGK_DIAG_MONITOR_STATE enumeration is a member of the DXGK_DISPLAYSTATE_INTRUSIVE structure. It is used while gathering display diagnostic information via calls to DxgkDdiGetDisplayStateIntrusive.

In many situations, the driver needs to initialize the monitor and set it up (typically by sending a command sequence) before it can start sending pixels to the monitor. Additionally, there might be some driver-initiated negotiation/handshaking done with the monitor before pixels can be sent. DXGK_DIAG_MONITOR_STATE specifies the final state of the monitors according to the miniport driver, indicating to the OS whether the monitors are ready to receive the pixels.

[!NOTE] In some cases (like DisplayPort), DXGK_DIAG_MONITOR_STATE might overlap with DXGK_DIAG_DISPLAY_LINK_STATE. The purpose of this enumeration is to get the overall current status of the monitor irrespective of the bus/link state.

See also

DXGK_DIAG_DISPLAY_LINK_STATE

DXGK_DISPLAYSTATE_INTRUSIVE

DXGKARG_GETDISPLAYSTATEINTRUSIVE

DxgkDdiGetDisplayStateIntrusive