DXTRACE_MSG

Output a debug message for a failed function call.

#define DXTRACE_MSG(str) 

Parameters

str

[in] Type is char* *. Pointer to a user-supplied debug message that will be passed to the debugger.

Return Values

Returns zero if successful, or a nonzero value if not.

Remarks

For example, if you call DXTRACE_MSG with:

    DXTRACE_MSG( "Call failed" ) 

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

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 this message in the debug output window.

If you are interested in returning the error code also, see DXTRACE_ERR.