Return Values
Errors are represented by 32-bit values. This table lists the values that can be returned by Direct3DX methods and functions. See the individual descriptions for lists of the values that each can return.
- D3DX_OK
- No error occurred.
- D3DXERR_BADD3DXCONTEXT
- The requested operation failed because the Direct3DX context is invalid.
- D3DXERR_BITBLTFAILED
- A call to the BitBlt method failed.
- D3DXERR_CANNOTRESIZEFULLSCREEN
- The requested operation failed because resize does not work in full-screen mode.
- D3DXERR_CANNOTRESIZENONWINDOWED
- The requested operation failed because resize does not work for non-windowed contexts.
- D3DXERR_CAPSNOTSUPPORTED
- The requested device capabilities are not supported.
- D3DXERR_COLORDEPTHTOOLOW
- The requested operation failed because Direct3DX only supports color depths of 16-bit or greater.
- D3DXERR_COULDNTUPDATECAPS
- The capabilities database failed to update after changing the display mode.
- D3DXERR_D3DXNOTSTARTEDYET
- The requested operation failed because Direct3DX has not been initialized. Initialize Direct3DX by calling the D3DXInitialize function and trying again.
- D3DXERR_ENUMFORMATSFAILED
- An error occurred while enumerating surface formats.
- D3DXERR_FAILEDDRAWTEXT
- Text failed to render to the surface.
- D3DXERR_FAILEDGETCAPS
- Device capabilities could not be obtained.
- D3DXERR_FAILEDQUATSLERP
- A slerping operation between two quaternions failed.
- D3DXERR_FRONTBUFFERALREADYEXISTS
- The requested operation failed because a front buffer already exists.
- D3DXERR_FULLSCREENPRIMARYEXISTS
- The requested operation failed because the application is using the primary surface in full-screen mode.
- D3DXERR_GETDCFAILED
- Device information could not be retrieved.
- D3DXERR_IFLERROR
- An error occurred in the image file loading library.
- D3DXERR_INITFAILED
- Direct3DX failed to initialize itself.
- D3DXERR_INVALIDD3DXDEVICEINDEX
- The requested operation failed because the device index passed in is invalid.
- D3DXERR_INVALIDFILEFORMAT
- The file format is invalid.
- D3DXERR_INVALIDMODE
- The requested operation failed because the display mode is invalid.
- D3DXERR_INVALIDPARAMETER
- The requested operation failed because one or more of the parameters passed is invalid.
- D3DXERR_MIPLEVELABSENT
- The requested operation failed because there is no such mipmap level for this surface.
- D3DXERR_NOBACKBUFFERAVAILABLE
- The requested operation failed because the back-buffer surface has not been created.
- D3DXERR_NODIRECTDRAWAVAILABLE
- The requested operation failed because a DirectDraw object has not been created.
- D3DXERR_NODIRECT3DAVAILABLE
- The requested operation failed because a Direct3D object has not been created.
- D3DXERR_NODIRECT3DDEVICEAVAILABLE
- The requested operation failed because a Direct3D device has not been created.
- D3DXERR_NOMATCHFOUND
- No suitable match found.
- D3DXERR_NOMEMORY
- The requested operation failed because the system is out of memory.
- D3DXERR_NOPRIMARYAVAILABLE
- The requested operation failed because the primary surface has not been created.
- D3DXERR_NOTEXTURE
- The requested operation failed because there is no surface backing up this texture.
- D3DXERR_NOTINITIALIZED
- The requested operation failed because Direct3DX is not initialized.
- D3DXERR_NOZBUFFER
- The z-buffer surface could not be created.
- D3DXERR_NOZBUFFERAVAILABLE
- The requested operation failed because the z buffer surface has not been created.
- D3DXERR_NULLHWND
- The requested operation failed because a HWND cannot be NULL in windowed mode.
- D3DXERR_NULLPOINTER
- The requested operation failed because a NULL pointer was passed as a parameter.
- D3DXERR_SINGULARMATRIX
- The matrix cannot be inverted.
- D3DXERR_STARTUPFAILED
- Direct3DX failed to start up.
- D3DXERR_SURFACENOTPALETTED
- The requested operation failed because the surface is not paletted.
- D3DXERR_UNSUPPORTEDFILEFORMAT
- The requested operation failed because the image file format is unrecognized.