Microsoft DirectX 8.0 (C++)

DXTRACE_ERR

Displays a message box with error information.

HRESULT DXTRACE_ERR(
  char *str,
  HRESULT hr
);

Parameters

str
Pointer to a string to be displayed in the message box.
hr
HRESULT containing an error code. This value will be passed to DXGetErrorString8 and converted to the equivalent name.

Return Values

Returns zero if successful, or a non-zero value if not.

Remarks

The string and error name is accompanied by the file name and line number. The macro declaration is:

DXTRACE_ERR(str,hr) DXTrace(__FILE__,(DWORD)__LINE__,hr,str,TRUE )

Requirements

  Windows NT/2000: Requires Windows® 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Version: Requires DirectX® 8.0.
  Header: Declared in Dxerr8.h.