| Previous | Next |
| STATUS_GRAPHICS_PRESENT_MODE_CHANGED | STATUS_GRAPHICS_PRESENT_DENIED |
STATUS_GRAPHICS_PRESENT_OCCLUDED
STATUS_GRAPHICS_PRESENT_OCCLUDED is a visibility condition: the presentation path had nothing to display because the desktop output was occluded. It should not be treated as an allocation error, a device reset, or evidence that the rendering command stream is invalid.
The right check is why the output was not visible at that instant. Examples include an obscured fullscreen surface, a display transition, a temporary desktop-state change, or a target that is no longer the active visible output for the session.
How to handle it
- Log window visibility, target attachment state, and the current display topology with the present attempt.
- Throttle work that exists only to feed an invisible output; do not spin in a tight present-and-retry loop.
- Re-evaluate presentation eligibility after a visibility, session, or display-configuration notification.
Occlusion is often transient. The useful evidence is the transition into and out of the occluded state, not an isolated count of returned statuses.
References
Looking for a different code? Search another status or error code.