共用方式為


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