DXTrace

Displays a message box, and passes the error code to DXGetErrorString.

HRESULT DXTrace(
  CHAR * strFile,
  DWORD dwline,
  HRESULT hr,
  CHAR * strMsg,
  BOOL bPopMsgBox
);

Parameters

strFile

[in] Pointer to the name of the current file. You can set this parameter easily with the __FILE__ macro.

dwline

[in] Line number. You can set this parameter easily with the __LINE__ macro.

hr

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

strMsg

[in] Pointer to an optional message that will be displayed along with the file name, line number, and HRESULT.

bPopMsgBox

[in] Specifies whether a message box should be displayed. If bPopMsgBox is set to TRUE, a message box will be displayed containing the values of the first four parameters. If bPopMsgBox is set to FALSE, the message box is not displayed.

Return Values

Returns the HRESULT that was assigned to hr.

Requirements

Header: Declared in Dxerr.h.