glGetError 関数
glGetError 関数はエラー情報を返します。
構文
GLenum WINAPI glGetError(void);
パラメーター
この関数にはパラメーターはありません。
戻り値
glGetError 関数は、次のいずれかのエラー コードを返します。
| リターン コード | 説明 |
|---|---|
|
列挙された引数に許容できない値が指定されています。 問題のある関数は無視され、エラー フラグを設定する以外に副作用はありません。 |
|
数値引数が範囲外です。 問題のある関数は無視され、エラー フラグを設定する以外に副作用はありません。 |
|
指定された操作は、現在の状態では許可されません。 問題のある関数は無視され、エラー フラグを設定する以外に副作用はありません。 |
|
エラーは記録されていません。 このシンボリック定数の値は 0 であることが保証されます。 |
|
この関数はスタック オーバーフローを引き起こします。 問題のある関数は無視され、エラー フラグを設定する以外に副作用はありません。 |
|
この関数により、スタックのアンダーフローが発生します。 問題のある関数は無視され、エラー フラグを設定する以外に副作用はありません。 |
|
関数を実行するのに十分なメモリが残っていない。 このエラーが記録された後のエラー フラグの状態を除き、OpenGL の状態は未定義です。 |
glBegin の呼び出しとそれに対応する glEnd の呼び出しの間に呼び出された場合、glGetError はGL_INVALID_OPERATIONを返します。
解説
検出可能な各エラーには、数値コードとシンボリック名が割り当てられます。 エラーが発生すると、エラー フラグは適切なエラー コード値に設定されます。 glGetError が呼び出され、エラー コードが返され、フラグが GL_NO_ERROR にリセットされるまで、他のエラーは記録されません。 glGetError の呼び出しがGL_NO_ERRORを返した場合、glGetError の最後の呼び出し以降、または OpenGL が初期化されてから検出可能なエラーはありません。
分散実装を可能にするために、いくつかのエラー フラグが存在する可能性があります。 1 つのエラー フラグでエラーが記録された場合、そのフラグの値が返され、 glGetError が呼び出されたときにそのフラグがGL_NO_ERRORにリセットされます。 複数のフラグでエラーが記録されている場合、 glGetError は 任意のエラー フラグ値を返してクリアします。 すべてのエラー フラグをリセットする場合は、GL_NO_ERRORを返すまで、常に ループで glGetError を呼び出す必要があります。
最初は、すべてのエラー フラグが GL_NO_ERROR に設定されます。
エラー フラグが設定されている場合、OpenGL 操作の結果は、GL_OUT_OF_MEMORYが発生した場合にのみ未定義になります。 それ以外のすべての場合、エラーを生成する関数は無視され、OpenGL 状態またはフレームバッファーの内容には影響しません。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|