glGetError 函数

glGetError 函数返回错误信息。

语法

GLenum WINAPI glGetError(void);

parameters

此函数没有参数。

返回值

glGetError 函数返回以下错误代码之一。

返回代码 说明
GL _ 无效 _ 枚举
为枚举参数指定不可接受的值。 将忽略有问题的函数,除了设置错误标志外没有副作用。
GL _ 无效 _ 值
数值参数在范围内。 将忽略有问题的函数,除了设置错误标志外没有副作用。
GL _ 无效 _ 操作
当前状态中不允许指定操作。 将忽略有问题的函数,除了设置错误标志外没有副作用。
GL _ NO _ 错误
未记录任何错误。 此符号常量的值保证为零。
GL _ STACK _ OVERFLOW
此函数会导致堆栈溢出。 将忽略有问题的函数,除了设置错误标志外没有副作用。
GL _ STACK _ 下溢
此函数会导致堆栈下溢。 将忽略有问题的函数,除了设置错误标志外没有副作用。
GL _ _ 内存 _ 不足
内存不足,无法执行函数。 记录此错误后,OpenGL 的状态未定义,错误标志的状态除外。

请注意,如果在对 glBegin 的调用与 glEnd 的相应调用之间调用 glGetError,则 glGetError 将返回 _ GL INVALID _ OPERATION。

备注

每个可检测的错误都分配有一个数字代码和符号名称。 发生错误时,错误标志设置为相应的错误代码值。 在调用 glGetError、 返回错误代码以及将标志重置为 GL NO ERROR 之前,不会 _ 记录任何其他 _ 错误。 如果对 glGetError 的调用返回 GL NO ERROR,则自上次调用 _ _ glGetError 或自 OpenGL 初始化以来,没有可检测到的错误。

若要允许分布式实现,可能有几个错误标志。 如果任何单个错误标志记录错误,则返回该标志的值,调用 _ _ glGetError 时,该标志将重置为 GL NO ERROR。 如果多个标志记录错误 ,glGetError 将返回并清除任意错误标志值。 如果要重置所有错误标志,应始终在循环中调用 glGetError, 直到它返回 GL _ NO _ ERROR。

最初,所有错误标志都设置为 GL _ NO _ ERROR。

设置错误标志时,只有在发生 GL OUT OF MEMORY 时,OpenGL _ 操作 _ _ 的结果才不确定。 在所有其他情况下,生成错误的函数将被忽略,并且对 OpenGL 状态或帧缓冲区内容没有影响。

要求

要求
最低受支持的客户端
Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器
Windows 2000 Server [仅限桌面应用]
标头
Gl.h

Opengl32.lib
DLL
Opengl32.dll

请参阅

glBegin

glEnd