Microsoft DirectX 8.0 (C++)

DXGetErrorString8

Microsoft® DirectX® のエラー コードに関連付けられている名前を返す。

TCHAR* DXGetErrorString8(
  HRESULT hr
);

パラメータ

hr
[in] DirectX メソッドによって返される HRESULT 値。エラー コード専用。

戻り値

成功した場合は、指定されたエラー コードの名前を含む文字列へのポインタを返す。Unicode が設定されている場合、DXGetErrorString8 は Unicode の文字列を返す。それ以外の場合は、ANSI 文字列を返す。

注意

この関数は、Microsoft Direct3D®、D3DX、DirectPlay®、DirectInput®、DirectMusic®、または DirectSound® のメソッドからの DirectX エラー メッセージと等価なテキストを取得する。たとえば、hr を 0x88768686 に設定した場合、DXGetErrorString8 は D3DERR_DEVICELOST を返す。

1 つのエラー コードが複数のテキスト文字列に対応している場合、DXGetErrorString8 は汎用的な文字列を返す。たとえば、メモリ不足を示す DirectX エラー コードは、DIERR_OUTOFMEMORY など複数あるが、これらはすべて同じ値に対応付けられる。hr をこれらのコードのいずれかに設定した場合、DXGetErrorString8 は E_OUTOFMEMORY を返す。

動作環境

  Windows NT/2000 : Windows® 2000 が必要。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  バージョン : DirectX 8.0 が必要。
  ヘッダー : Dxerr8.h で宣言。
  インポート ライブラリ : Dxerr8.lib を使用。