DXTRACE_ERR

Output a debug message and the failed return value for a failed function call.

#define DXTRACE_ERR(str,hr) 

Parameters

str

[in] Type is char*. Pointer to a string to be passed to the debugger.

hr

[in] Type is HRESULT. HRESULT containing an error code. This value will be passed to DXGetErrorString and converted to the equivalent name.

Return Values

Returns the HRESULT that was assigned to hr.

Remarks

For example, if you call DXTRACE_ERR with:

    DXTRACE_ERR( "Call failed", D3DERR_INVALIDCALL ) 

A function call that fails will output a debug message in the output window of the compiler similar to this one:

    c:\basichlsl\basichlsl.cpp(242): Call failed hr=D3DERR_INVALIDCALL (0x8876086c)

This identifies the file and line number of the function call that fails. You must be running a debug build to see the message. If you are using the Visual Studio .NET debugger, you can jump to the line of source code where the error occurred by double-clicking on this message in the debug output window.

If you are not interested in returning the error code, see DXTRACE_MSG.