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 enumeriertes Argument wird ein inakzeptabler Wert angegeben. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen. |
|
Ein numerisches Argument liegt außerhalb des Bereichs. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen. |
|
Der angegebene Vorgang ist im aktuellen Zustand nicht zulässig. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen. |
|
Es wurde kein Fehler aufgezeichnet. Der Wert dieser symbolischen Konstanten ist garantiert null. |
|
Diese Funktion würde einen Stapelüberlauf verursachen. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen. |
|
Diese Funktion würde einen Stapelunterlauf verursachen. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen. |
|
Es ist nicht mehr genügend Arbeitsspeicher vorhanden, um die Funktion auszuführen. Der Status 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 weiteren 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 Fehler erkennbar.
Um verteilte Implementierungen zuzulassen, können mehrere Fehlerflags vorhanden sein. 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 zurück und löscht einen beliebigen Fehlerflagwert. Wenn alle Fehlerflags zurückgesetzt werden sollen, sollten Sie glGetError immer in einer Schleife aufrufen, bis GL_NO_ERROR zurückgegeben wird.
Zunächst sind alle Fehlerflags auf GL_NO_ERROR festgelegt.
Wenn ein Fehlerflag festgelegt ist, sind die Ergebnisse eines OpenGL-Vorgangs nur dann undefiniert, 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 den Framebuffer-Inhalt.
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 |
|