Microsoft DirectX 8.0 (C++) |
Microsoft® DirectX® のエラー コードに関連付けられている名前を返す。
TCHAR* DXGetErrorString8( HRESULT hr );
成功した場合は、指定されたエラー コードの名前を含む文字列へのポインタを返す。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 を使用。