What does HRESULT 0x88980801 (DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED) mean?

 
Previous Next
DCOMPOSITION_ERROR_WINDOW_ALREADY_COMPOSED DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED

DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED

What Windows rejected: surface being rendered

DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, value 0x88980801, is produced by dcomp when a new rendering operation was requested while BeginDraw state was already active for the surface. The investigation should stay attached to DirectComposition surface update lifetime and to the exact generation in which it was obtained.

DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED: DirectComposition batches changes until Commit, while surface drawing has its own BeginDraw/EndDraw lifetime. For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, Treat those two transactions separately in traces and cleanup. For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, the built-in one-line message identifies the immediate result; diagnosis also needs the producing API, object ownership and the display generation current at the time.

Build a useful diagnostic record

Capture itemWhy it matters for DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED
Current graph stateDirectComposition device, target, visual tree and surface update transaction
Supporting traceBeginDraw/EndDraw or target-creation sequence, Commit result, HWND ownership and CheckDeviceState output
Object identityDirectComposition surface update lifetime
Rejected boundarya new rendering operation was requested while BeginDraw state was already active for the surface
Decisive capturesurface identity, BeginDraw/EndDraw pairs, update rectangle, drawing thread and exception paths

For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, preserve the unsigned HRESULT, symbolic name, first failing API and timestamp in one record. If cleanup later fails too, keep that secondary result separately from DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED.

Separate state from capability

  1. Freeze the DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED generation. Record surface identity, BeginDraw/EndDraw pairs, update rectangle, drawing thread and exception paths. Before diagnosing DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, do not resize, hot-plug, recreate or release the object under examination.
  2. Run the narrow DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED comparison. call BeginDraw twice without the matching EndDraw and compare with a balanced update. During the DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED comparison, keep every driver, monitor, resource format and unrelated policy unchanged.
  3. Observe the layer after DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED. For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, if the exact check passes, record the next HRESULT or visible outcome. A different downstream result shows that the DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED boundary was crossed.
  4. Repeat DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED through a lifecycle transition. For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, exercise one relevant resize, mode switch, device recreation, hot-plug or session change and confirm that this result does not reuse stale handles.

The comparison with DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED is especially useful: DCOMPOSITION_ERROR_SURFACE_NOT_BEING_RENDERED is the opposite imbalance. For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, recording both names prevents a broad “graphics error” label from merging distinct ownership, capability and lifetime problems.

Verify the repaired path

Serialize surface updates and guarantee EndDraw through structured cleanup before beginning another frame. Repair of DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED is complete only when the original call succeeds or returns its documented nonfatal status and the same lifetime test remains correct after a second display transition.

  • The DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED trace identifies one producing API and one current graphics object, rather than only the final UI symptom.
  • The passing run changes exactly the condition described for DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED; unrelated adapter, monitor and application state remains unchanged.
  • For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, debug-layer, ETW or driver diagnostics no longer report the rejected DirectComposition surface update lifetime contract during the same scenario.
  • The application handles recurrence of DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED without an unbounded retry loop, leaked resource, duplicate composition target or stale topology handle.

Implementation notes for DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED

For DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED, log BeginDraw/EndDraw or target-creation sequence, Commit result, HWND ownership and CheckDeviceState output. When the DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED path returns a count, size, status flag or replacement object, retain it even on a nonfatal result because it can direct the next call.

A production fallback for DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED should be explicit: pause rendering, re-enumerate, rebuild one cache entry, recreate a device, or decline a protected path only when this layer calls for that action. Reinstalling every display component, deleting all caches or forcing a resolution change is not an evidence-based fix for DCOMPOSITION_ERROR_SURFACE_BEING_RENDERED.

Technical references


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