HRESULT 0x887A0001 (DXGI_ERROR_INVALID_CALL): meaning and diagnosis

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

The application made a call that is invalid. Either the parameters of the call or the state of some object was incorrect. Enable the D3D debug layer in order to see details via debug messages.

Previous	Next
D3D10_ERROR_FILE_NOT_FOUND	DXGI_ERROR_NOT_FOUND

DXGI_ERROR_INVALID_CALL

DXGI_ERROR_INVALID_CALL means that a DXGI or Direct3D call received invalid parameter data or was made while an object was in a state that does not permit that operation. It is an application-side programming error, not a transient graphics-driver failure to hide with a retry.

What to capture

The exact DXGI or Direct3D method, its arguments, the object type, and the HRESULT returned.
The sequence of state-changing calls immediately before the failure, especially resize, fullscreen, sharing, and desktop-duplication operations.
Debug-layer messages from a development build, which usually identify the invalid argument or state rule more precisely.

Correct response

Fix the caller and preserve the failed call in a minimal reproduction. Retrying the identical call can make a state bug intermittent but does not make it valid. If the error follows a device-removal event, handle that event first and recreate invalid device-dependent objects before issuing further graphics calls.

Microsoft: DXGI error codes · Microsoft: Direct3D diagnostics

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