What does HRESULT 0xC02625E0 (ERROR_GRAPHICS_ONLY_CONSOLE_SESSION_SUPPORTED) mean?

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

This function can only be used if a program is running in the local console session. It cannot be used if the program is running on a remote desktop session or on a terminal server session.

Previous	Next
ERROR_GRAPHICS_MCA_UNSUPPORTED_COLOR_TEMPERATURE	ERROR_GRAPHICS_NO_DISPLAY_DEVICE_CORRESPONDS_TO_NAME

ERROR_GRAPHICS_ONLY_CONSOLE_SESSION_SUPPORTED

Why this is not a generic GPU failure: graphics only console session supported

Windows reports ERROR_GRAPHICS_ONLY_CONSOLE_SESSION_SUPPORTED (0xC02625E0) at the gdi monitor checkpoint. Here, the monitor/display operation is not available from Remote Desktop or another terminal-services session. That narrows the first investigation to local-console session requirement instead of the entire GPU stack.

The smallest evidence set

Capture item	Why it matters
Object identity	local-console session requirement
Rejected condition	the monitor/display operation is not available from Remote Desktop or another terminal-services session
What to capture	process session ID, active console session, remote protocol, user token and target display device
Current graph state	GDI display-device enumeration, desktop attachment and physical-monitor mapping
Supporting trace	EnumDisplayDevices snapshot, DISPLAY_DEVICE flags, session ID, HMONITOR list and physical-monitor count

A/B test for the exact condition

Capture the failing state. Record process session ID, active console session, remote protocol, user token and target display device.
Run the same operation locally at the console and through an RDP session.

The comparison with DXGI_ERROR_SESSION_DISCONNECTED is especially useful: DXGI_ERROR_SESSION_DISCONNECTED concerns loss of a graphics session rather than an API console-only rule.

Safe remediation

Perform physical-monitor control in an authorized local-console component and return capability status to remote callers.

debug-layer, ETW or driver diagnostics no longer report the rejected local-console session requirement contract during the same scenario.

Implementation notes

Technical references

Microsoft: Multiple display monitors — background for the local-console session requirement.
Microsoft: Monitor configuration functions
Microsoft: EnumDisplayDevices
Microsoft: Graphics error codes

Looking for a different code? Search another status or error code.