glGetError-Funktion
Die glGetError-Funktion gibt Fehlerinformationen zurück.
Syntax
GLenum WINAPI glGetError(void);
Parameter
Diese Funktion besitzt keine Parameter.
Rückgabewert
Die glGetError-Funktion gibt einen der folgenden Fehlercodes zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Für ein aufzählbares Argument wird ein unzulässiger Wert angegeben. Die beleidigende Funktion wird ignoriert und hat keine andere Nebeneffekt als das Festlegen des Fehlerflags. |
|
Ein numerisches Argument liegt nicht im Bereich. Die beleidigende Funktion wird ignoriert und hat keine andere Nebeneffekt als das Festlegen des Fehlerflags. |
|
Der angegebene Vorgang ist im aktuellen Zustand nicht zulässig. Die beleidigende Funktion wird ignoriert und hat keine andere Nebeneffekt als das Festlegen des Fehlerflags. |
|
Es wurde kein Fehler aufgezeichnet. Der Wert dieser symbolischen Konstante ist garantiert 0 (null). |
|
Diese Funktion würde einen Stapelüberlauf verursachen. Die beleidigende Funktion wird ignoriert und hat keine andere Nebeneffekt als das Festlegen des Fehlerflags. |
|
Diese Funktion würde einen Stapel unterlauf verursachen. Die beleidigende Funktion wird ignoriert und hat keine andere Nebeneffekt als das Festlegen des Fehlerflags. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um die Funktion auszuführen. Der Zustand von OpenGL ist nicht definiert, mit Ausnahme des Status der Fehlerflags, nachdem dieser Fehler aufgezeichnet wurde. |
Beachten Sie, dass glGetError GL INVALID OPERATION zurückgibt, wenn es zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von _ _ glEnd aufgerufen wird.
Bemerkungen
Jedem erkennbaren Fehler wird ein numerischer Code und ein symbolischer Name zugewiesen. Wenn ein Fehler auftritt, wird das Fehlerflag auf den entsprechenden Fehlercodewert festgelegt. Es werden keine anderen Fehler aufgezeichnet, bis glGetError aufgerufen, der Fehlercode zurückgegeben und das Flag auf GL _ NO ERROR zurückgesetzt _ wird. Wenn ein Aufruf von glGetError GL NO ERROR zurückgibt, ist seit dem letzten Aufruf von glGetError oder seit der Initialisierung von OpenGL kein _ _ erkennbarer Fehler aufgetreten.
Um verteilte Implementierungen zu ermöglichen, gibt es möglicherweise mehrere Fehlerflags. Wenn ein einzelnes Fehlerflag einen Fehler aufgezeichnet hat, wird der Wert dieses Flags zurückgegeben, und dieses Flag wird auf GL NO ERROR zurückgesetzt, wenn _ _ glGetError aufgerufen wird. Wenn mehrere Flags einen Fehler aufgezeichnet haben, gibt glGetError einen beliebigen Fehlerflagwert zurück und clears. Wenn alle Fehlerflags zurückgesetzt werden sollen, sollten Sie glGetError immer in einer Schleife aufrufen, bis GL _ NO ERROR zurückgegeben _ wird.
Anfänglich werden alle Fehlerflags auf GL _ NO _ ERROR festgelegt.
Wenn ein Fehlerflag festgelegt wird, sind die Ergebnisse eines OpenGL-Vorgangs nur dann nicht definiert, wenn GL _ OUT OF MEMORY aufgetreten _ _ ist. In allen anderen Fällen wird die Funktion, die den Fehler generiert, ignoriert und hat keine Auswirkungen auf den OpenGL-Zustand oder framebuffer-Inhalt.
Requirements (Anforderungen)
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
| Header |
|
| Bibliothek |
|
| DLL |
|