What does HRESULT 0x087A0002 (DXGI_STATUS_CLIPPED) mean?

 
Previous Next
DXGI_STATUS_OCCLUDED DXGI_STATUS_NO_REDIRECTION

DXGI_STATUS_CLIPPED

Interpret the result in its owning layer: status clipped

The useful interpretation of DXGI_STATUS_CLIPPED (0x087A0002) starts at the dxgi status boundary: the frame was accepted while only part of the swap-chain target was visible. In practical terms, inspect presentation clipping state before changing application-wide graphics settings.

Capture before recreating objects

Capture itemWhy it matters
Rejected conditionthe frame was accepted while only part of the swap-chain target was visible
What to capturewindow rectangle, clipping region, desktop scaling, output rectangle and Present statistics around the transition
Current graph stateswap chain, target window, output and Present call
Supporting tracePresent/Present1 result history, WM_SIZE or WM_DISPLAYCHANGE messages, swap-chain description and current IDXGIOutput identity
Object identitypresentation clipping state

Reproduce one variable at a time

  1. Capture the failing state. Record window rectangle, clipping region, desktop scaling, output rectangle and Present statistics around the transition.
  2. Move another top-level window over only part of the target and compare with full occlusion.

The comparison with DXGI_STATUS_OCCLUDED is especially useful: DXGI_STATUS_OCCLUDED means no part of the presentation was visible.

Recovery contract

Treat the status as visibility feedback, not as a device failure; continue or reduce work according to application policy.

  • debug-layer, ETW or driver diagnostics no longer report the rejected presentation clipping state contract during the same scenario.

Implementation notes

Technical references


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