DXGI_ERROR

Error codes that can be returned by a DXGI function.

Constant/valueDescription
DXGI_ERROR_DEVICE_HUNG
0x887A0006

The application's device failed due to badly formed commands sent by the application. This is an design-time issue that should be investigated and fixed.

DXGI_ERROR_DEVICE_REMOVED
0x887A0005

The video card has been physically removed from the system, or a driver upgrade for the video card has occurred. The application should destroy and recreate the device. For help debugging the problem, call ID3D10Device::GetDeviceRemovedReason.

DXGI_ERROR_DEVICE_RESET
0x887A0007

The device failed due to a badly formed command. This is a run-time issue; The application should destroy and recreate the device.

DXGI_ERROR_DRIVER_INTERNAL_ERROR
0x887A0020

The driver encountered a problem and was put into the device removed state.

DXGI_ERROR_FRAME_STATISTICS_DISJOINT
0x887A000B

An event (for example, a power cycle) interrupted the gathering of presentation statistics.

DXGI_ERROR_GRAPHICS_VIDPN_SOURCE_IN_USE
0x887A000C

The application attempted to acquire exclusive ownership of an output, but failed because some other application (or device within the application) already acquired ownership.

DXGI_ERROR_INVALID_CALL
0x887A0001

The application provided invalid parameter data; this must be debugged and fixed before the application is released.

DXGI_ERROR_MORE_DATA
0x887A0003

The buffer supplied by the application is not big enough to hold the requested data.

DXGI_ERROR_NONEXCLUSIVE
0x887A0021

A global counter resource is in use, and the Direct3D device can't currently use the counter resource.

DXGI_ERROR_NOT_CURRENTLY_AVAILABLE
0x887A0022

The resource or request is not currently available, but it might become available later.

DXGI_ERROR_NOT_FOUND
0x887A0002

When calling IDXGIObject::GetPrivateData, the GUID passed in is not recognized as one previously passed to IDXGIObject::SetPrivateData or IDXGIObject::SetPrivateDataInterface. When calling IDXGIFactory::EnumAdapters or IDXGIAdapter::EnumOutputs, the enumerated ordinal is out of range.

DXGI_ERROR_REMOTE_CLIENT_DISCONNECTED
0x887A0023

Reserved

DXGI_ERROR_REMOTE_OUTOFMEMORY
0x887A0024

Reserved

DXGI_ERROR_WAS_STILL_DRAWING
0x887A000A

The GPU was busy at the moment when a call was made to perform an operation, and did not execute or schedule the operation.

DXGI_ERROR_UNSUPPORTED
0x887A0004

The requested functionality is not supported by the device or the driver.

DXGI_ERROR_ACCESS_LOST
0x887A0026

The desktop duplication interface is invalid. The desktop duplication interface typically becomes invalid when a different type of image is displayed on the desktop.

DXGI_ERROR_WAIT_TIMEOUT
0x887A0027

The time-out interval elapsed before the next desktop frame was available.

DXGI_ERROR_SESSION_DISCONNECTED
0x887A0028

The Remote Desktop Services session is currently disconnected.

DXGI_ERROR_RESTRICT_TO_OUTPUT_STALE
0x887A0029

The DXGI output (monitor) to which the swap chain content was restricted is now disconnected or changed.

DXGI_ERROR_CANNOT_PROTECT_CONTENT
0x887A002A

DXGI can't provide content protection on the swap chain. This error is typically caused by an older driver, or when you use a swap chain that is incompatible with content protection.

DXGI_ERROR_ACCESS_DENIED
0x887A002B

You tried to use a resource to which you did not have the required access privileges. This error is most typically caused when you write to a shared resource with read-only access.

DXGI_ERROR_NAME_ALREADY_EXISTS
0x887A002C

The supplied name of a resource in a call to IDXGIResource1::CreateSharedHandle is already associated with some other resource.

S_OK

The method succeeded without an error.

Remarks

You may be interested only in whether the method succeeded or failed. The best way to test whether an HRESULT value indicates success or failure is to pass the value to the one of the following macros, defined in WinError.h:

  • The SUCCEEDED macro returns TRUE for a success code and FALSE for a failure code.
  • The FAILED macro returns TRUE for a failure code and FALSE for a success code.

The HRESULT value for each DXGI_ERROR value is determined from this macro that is defined in DXGItype.h:



#define _FACDXGI    0x87a
#define MAKE_DXGI_HRESULT(code) MAKE_HRESULT(1, _FACDXGI, code)


For example, DXGI_ERROR_INVALID_CALL is defined as 0x887A0001:



#define DXGI_ERROR_INVALID_CALL                 MAKE_DXGI_HRESULT(1)


Requirements

Header

DXGItype.h

See also

DXGI Constants

 

 

Community Additions

ADD
Show:
© 2014 Microsoft