HRESULT 0xC02625E4 (ERROR_GRAPHICS_INVALID

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

The function failed because an invalid pointer parameter was passed to it. A pointer parameter is invalid if it is NULL, points to an invalid address, points to a kernel mode address, or is not correctly aligned.

Previous	Next
ERROR_GRAPHICS_MIRRORING_DEVICES_NOT_SUPPORTED	ERROR_GRAPHICS_NO_MONITORS_CORRESPOND_TO_DISPLAY_DEVICE

ERROR_GRAPHICS_INVALID_POINTER

What Windows rejected: graphics invalid pointer

Windows reports ERROR_GRAPHICS_INVALID_POINTER (0xC02625E4) at the gdi monitor checkpoint. Here, one of the pointer arguments is null, inaccessible, kernel-addressed or incorrectly aligned. That narrows the first investigation to graphics configuration API pointer contract instead of the entire GPU stack.

Build a useful diagnostic record

Capture item	Why it matters
Supporting trace	EnumDisplayDevices snapshot, DISPLAY_DEVICE flags, session ID, HMONITOR list and physical-monitor count
Object identity	graphics configuration API pointer contract
Rejected condition	one of the pointer arguments is null, inaccessible, kernel-addressed or incorrectly aligned
What to capture	API name, pointer values, buffer sizes, alignment, process bitness and structure version
Current graph state	GDI display-device enumeration, desktop attachment and physical-monitor mapping

Separate state from capability

Capture the failing state. Record API name, pointer values, buffer sizes, alignment, process bitness and structure version.
Replace caller buffers with local correctly sized structures and repeat.

The comparison with ERROR_GRAPHICS_PARAMETER_ARRAY_TOO_SMALL is especially useful: ERROR_GRAPHICS_PARAMETER_ARRAY_TOO_SMALL reports adequate pointers with insufficient element capacity.

Verify the repaired path

Validate every optional/required pointer and length pair before crossing the API boundary.

debug-layer, ETW or driver diagnostics no longer report the rejected graphics configuration API pointer contract during the same scenario.

Implementation notes

Technical references

Microsoft: Multiple display monitors — background for the graphics configuration API pointer contract.
Microsoft: Monitor configuration functions
Microsoft: EnumDisplayDevices
Microsoft: Graphics error codes

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