DXTRACE_ERR

失敗した関数呼び出しのデバッグ メッセージと失敗の戻り値を出力します。

#define DXTRACE_ERR(str,hr) 

パラメータ

• str
  Type(Type) char* は. デバッガーに渡される文字列へのポインターです。
• hr
  Type(Type) HRESULT は. エラー コードを含む HRESULT です。この値は、DXGetErrorString に渡され、同等の名前に変換されます。

Return Values

hr に割り当てられた HRESULT を返します。

解説　

たとえば、次のコードで DXTRACE_ERR を呼び出します。

    DXTRACE_ERR( "Call failed", D3DERR_INVALIDCALL ) 

関数呼び出しが失敗すると、コンパイラの出力ウィンドウに、次のようなデバッグ メッセージが出力されます。

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

このエラー メッセージでは、失敗した関数呼び出しのファイルと行番号が明らかになります。Visual Studio デバッガーを使用している場合は、デバッグ出力ウィンドウ内でこのメッセージをダブルクリックすると、エラーが発生したソース コードの行にジャンプできます。

注    エラー メッセージを表示するには、デバッグ ビルドを実行している必要があります。

エラー コードを返さない場合は、「DXTRACE_MSG」を参照してください。