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
GL_INVALID_ENUM
Für ein enumeriertes Argument wird ein inakzeptabler Wert angegeben. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen.
GL_INVALID_VALUE
Ein numerisches Argument liegt außerhalb des Bereichs. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen.
GL_INVALID_OPERATION
Der angegebene Vorgang ist im aktuellen Zustand nicht zulässig. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen.
GL_NO_ERROR
Es wurde kein Fehler aufgezeichnet. Der Wert dieser symbolischen Konstanten ist garantiert null.
GL_STACK_OVERFLOW
Diese Funktion würde einen Stapelüberlauf verursachen. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen.
GL_STACK_UNDERFLOW
Diese Funktion würde einen Stapelunterlauf verursachen. Die beleidigende Funktion wird ignoriert, was keinen anderen Nebeneffekt hat, als das Fehlerflag festzulegen.
GL_OUT_OF_MEMORY
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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Siehe auch

glBegin

glEnd