HRESULT 0x887A0002 (DXGI_ERROR_NOT_FOUND): meaning and diagnosis

Status / error code:

Category:

Constant name:

Source:

Facility:

Operating System:

Description:

The object was not found. If calling IDXGIFactory::EnumAdaptes, there is no adapter with the specified ordinal.

Previous	Next
DXGI_ERROR_INVALID_CALL	DXGI_ERROR_MORE_DATA

DXGI_ERROR_NOT_FOUND

DXGI_ERROR_NOT_FOUND means that DXGI could not find the requested object. Its practical meaning depends on the API: an adapter or output enumeration index can be out of range, or a private-data GUID can be unknown to the object.

Make the missing object identifiable

For adapter and output enumeration, log the requested ordinal and the count returned by the preceding successful enumeration.
For private data, log the GUID and whether the same object previously received SetPrivateData or SetPrivateDataInterface.
Re-enumerate only when the display or adapter topology can genuinely have changed; do not assume a fixed ordinal identifies the same hardware forever.

Do not turn it into a generic hardware diagnosis

This code commonly reports an absent logical object rather than a faulty GPU. The failed method and its lookup key are the decisive evidence.

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

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