| 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 diagnostic question 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
- Microsoft: NTSTATUS reference
- Microsoft: querying Desktop Window Manager composition
- Microsoft: VidPN presentation model
Looking for a different code? Search another status or error code.