What does HRESULT 0x887A0029 (DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE) mean?

 
Previous Next
DXGI_ERROR_SESSION_DISCONNECTED DXGI_ERROR_CANNOT_PROTECT_CONTENT

DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE

DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE means that the monitor to which swap-chain content was restricted has been disconnected or changed. The output reference used by the application is no longer a current description of the display target.

Recovery steps

  • Re-enumerate adapters and outputs, then select a current output according to the application policy.
  • Recreate or reconfigure the swap chain with the new target instead of retaining a stale monitor reference.
  • Preserve the old and new output identities in diagnostics, including connector or monitor changes when available.

Why an immediate blind retry is weak

The old restriction is no longer valid, so issuing the same call with the same output object may repeat the failure. Treat this as a display-topology transition and rebuild the output-dependent state.

Microsoft: DXGI error codes · Microsoft: IDXGIFactory1::IsCurrent


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