Name

cgD3D10TranslateHRESULT - convert an HRESULT into a string

Synopsis

#include <Cg/cgD3D10.h>

const char * cgD3D10TranslateHRESULT( HRESULT hr );

Parameters

hr

The HRESULT to translate. Can be a generic HRESULT or a D3D runtime error.

Return Values

Returns a pointer to a string describing the error.

Description

cgD3D10TranslateHRESULT converts an HRESULT into a string. This routine should be called instead of DXGetErrorDescription10 because it will also translate errors that the Cg D3D runtime generates.

This routine will typically be called in debugging situations such as inside an error callback set using cgSetErrorCallback.

Examples

char buf[512];
HRESULT hres = cgD3D10GetLastError();
if (FAILED(hres))
{
    sprintf(buf, "A D3D error occurred. Error description: '%s'\n",
            cgD3D10TranslateHRESULT(hres));
    OutputDebugString(buf);
}

Errors

None.

History

cgD3D10TranslateHRESULT was introduced in Cg 2.1.

See Also

cgD3D10TranslateCGerror, cgGetErrorString, cgSetErrorCallback