glGetString 函数

glGetString 函数返回描述当前 OpenGL 连接的字符串。

语法

const GLubyte* WINAPI glGetString(
   GLenum name
);

参数

name

以下符号常量之一。

含义
GL_VENDOR
返回负责此 OpenGL 实现的公司。 此名称不会从发布更改为发布。
GL_RENDERER
返回呈现器的名称。 此名称通常特定于硬件平台的特定配置。 它不会从发布更改为发布。
GL_VERSION
返回版本或版本号。
GL_EXTENSIONS
返回 OpenGL 支持的扩展的空格分隔列表。

错误代码

glGetError 函数可以检索以下错误代码。

名称 含义
GL_INVALID_ENUM
name 不是接受的值。
GL_INVALID_OPERATION
在对 glBegin 的调用和对 glEnd 的相应调用之间调用了函数。

备注

glGetString 函数返回指向静态字符串的指针,该字符串描述当前 OpenGL 连接的某些方面。

由于 OpenGL 不包括对实现性能特征的查询,因此预期某些应用程序将编写以识别已知平台,并会根据这些平台的已知性能特征修改其 OpenGL 用法。 GL_VENDOR和GL_RENDERER一起的字符串唯一指定平台,并且不会从发布更改为发布。 平台识别算法应以此类方式使用它们。

glGetString 返回的字符串的格式和内容取决于实现,但以下情况除外:

  • 扩展名称将不包括空格字符,并将用GL_EXTENSIONS字符串中的空格字符分隔。

  • GL_VERSION字符串以版本号开头。 版本号使用以下形式之一:

    major_numberminor_number

    major_numberminor_numberrelease_number

  • 特定于供应商的信息可能遵循版本号。 其格式取决于实现,但空格始终分隔版本号和特定于供应商的信息。

  • 所有字符串都以 null 结尾。

如果生成错误, glGetString 返回零。

要求

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

Opengl32.lib
DLL
Opengl32.dll

另请参阅

glBegin

glEnd