DXTrace Function

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

Syntax

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 DXGetErrorString9 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 Value

Returns the HRESULT that was assigned to hr.

Function Information

Header	dxerr9.h
Import library	dxerr9.lib
Minimum operating systems	Windows 98