What does HRESULT 0x887A0027 (DXGI_ERROR_WAIT_TIMEOUT) mean?

 
Previous Next
DXGI_ERROR_ACCESS_LOST DXGI_ERROR_SESSION_DISCONNECTED

DXGI_ERROR_WAIT_TIMEOUT

DXGI_ERROR_WAIT_TIMEOUT means that the specified wait interval elapsed before the next desktop frame became available. For desktop capture, it can simply mean that no new frame arrived during the timeout; it is not automatically a device-loss condition.

Use a timeout that matches the application

  • Choose a bounded timeout that lets the capture loop observe shutdown, session, and display changes promptly.
  • On timeout, return to the event loop or schedule the next acquisition rather than treating the previous desktop image as new data.
  • Separate timeout statistics from capture failures so an idle desktop does not inflate an error rate.

Escalate only on the relevant result

Handle DXGI_ERROR_ACCESS_LOST by recreating duplication resources and DXGI_ERROR_SESSION_DISCONNECTED by waiting for an active session. Those results have different meanings from a simple elapsed wait.

Microsoft: IDXGIOutputDuplication::AcquireNextFrame · Microsoft: DXGI error codes


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