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
Ein unannehmbarer Wert wird für ein aufgezähltes Argument angegeben. Die Beleidigungsfunktion wird ignoriert, wobei keine Nebenwirkung besteht, als das Fehlerkennzeichen festzulegen.
GL_INVALID_VALUE
Ein numerisches Argument ist außerhalb des Bereichs. Die Beleidigungsfunktion wird ignoriert, wobei keine Nebenwirkung besteht, als das Fehlerkennzeichen festzulegen.
GL_INVALID_OPERATION
Der angegebene Vorgang ist im aktuellen Zustand nicht zulässig. Die Beleidigungsfunktion wird ignoriert, wobei keine Nebenwirkung besteht, als das Fehlerkennzeichen festzulegen.
GL_NO_ERROR
Es wurde kein Fehler aufgezeichnet. Der Wert dieser symbolischen Konstante ist garantiert null.
GL_STACK_OVERFLOW
Diese Funktion würde einen Stapelüberlauf verursachen. Die Beleidigungsfunktion wird ignoriert, wobei keine Nebenwirkung besteht, als das Fehlerkennzeichen festzulegen.
GL_STACK_UNDERFLOW
Diese Funktion würde einen Stapelunterlauf verursachen. Die Beleidigungsfunktion wird ignoriert, wobei keine Nebenwirkung besteht, als das Fehlerkennzeichen festzulegen.
GL_OUT_OF_MEMORY
Es gibt nicht genügend Speicher, um die Funktion auszuführen. Der Zustand von OpenGL ist nicht definiert, außer für den Zustand der Fehler flags, nachdem dieser Fehler aufgezeichnet wurde.

Beachten Sie, dass glGetError GL_INVALID_OPERATION zurückgibt, wenn sie zwischen einem Aufruf von glBegin und dem entsprechenden Aufruf von glEnd aufgerufen wird.

Bemerkungen

Jeder erkennende Fehler wird einem numerischen Code und einem symbolischen Namen zugewiesen. Wenn ein Fehler auftritt, wird das Fehlerzeichen auf den entsprechenden Fehlercodewert festgelegt. Es werden keine anderen Fehler aufgezeichnet, bis glGetError aufgerufen wird, der Fehlercode zurückgegeben wird, und das Flag wird auf GL_NO_ERROR zurückgesetzt. Wenn ein Aufruf von glGetError GL_NO_ERROR zurückgibt, gibt es seit dem letzten Aufruf von glGetError keinen erkennbaren Fehler oder seit der Initialisierung von OpenGL.

Um verteilte Implementierungen zu ermöglichen, gibt es möglicherweise mehrere Fehler flags. Wenn ein einzelnes Fehlerzeichen 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 mehr als ein Flag einen Fehler aufgezeichnet hat, gibt glGetError zurück und löscht einen beliebigen Fehler-Flagwert. Wenn alle Fehler flags zurückgesetzt werden sollen, sollten Sie immer glGetError in einer Schleife aufrufen, bis sie GL_NO_ERROR zurückgibt.

Zunächst werden alle Fehler flags auf GL_NO_ERROR festgelegt.

Wenn ein Fehler flag festgelegt wird, werden die Ergebnisse eines OpenGL-Vorgangs nur 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 Auswirkung auf den OpenGL-Zustand oder den 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
Gl.h
Bibliothek
Opengl32.lib
DLL
Opengl32.dll

Weitere Informationen

glBegin

glEnd