DXGetErrorString

  • [アーティクル]

DirectX コンポーネントおよび Win32 関数のエラー コードに関連付けられた名前を返します。

TCHAR * 
DXGetErrorString(
  HRESULT hr
);

パラメータ

  • hr
    任意の HRESULT リターン コードです。

戻り値

成功した場合、この関数はエラー コードの名前を含む文字列へのポインターを返します。Unicode が設定されている場合、この関数は Unicode 文字列を返し、そうでない場合は ANSI 文字列を返します。

解説　

この関数は、DirectX エラー メッセージに対応するテキストを取得するように設計されています。たとえば、hr を 0x88760686 に設定した場合、この関数は D3DERR_DEVICELOST を返します。エラー コードが複数のテキスト文字列にマップされている場合、標準の文字列が返されます。たとえば、メモリー不足エラーを示す複数のエラー コード (D3DERR_OUTOFVIDEOMEMORY など) があり、すべてのエラー コードは同じ値にマップされています。この場合、E_OUTOFMEMORY が返されます。

この関数は、次の DirectX コンポーネントの標準 Win32 エラー (Winerror.h. で定義) を処理します。それらは、Direct3D 9、Direct3D 10、D3DX 9、D3DX 10、DirectDraw、DirectInput、DirectSound、XACT、および XAudio2 です。

要件

ヘッダー: DXErr.h 宣言