glGetError 函式

GlGetError 函數會傳回錯誤資訊。

語法

GLenum WINAPI glGetError(void);

參數

此函式沒有參數。

傳回值

GlGetError 函數會傳回下列其中一個錯誤碼。

傳回碼 Description
GL _ 無效 _ 列舉
針對列舉引數指定了無法接受的值。 若未設定錯誤旗標,則會忽略有問題的函式,而不會有任何副作用。
GL _ 無效 _ 值
數值引數超出範圍。 若未設定錯誤旗標,則會忽略有問題的函式,而不會有任何副作用。
GL _ 不正確 _ 操作
目前的狀態不允許指定的作業。 若未設定錯誤旗標,則會忽略有問題的函式,而不會有任何副作用。
GL _ 沒有 _ 錯誤
未記錄任何錯誤。 此符號常數的值保證為零。
GL _ 堆疊 _ 溢位
此函數會導致堆疊溢位。 若未設定錯誤旗標,則會忽略有問題的函式,而不會有任何副作用。
GL _ 堆疊 _ 下溢
此函數會導致堆疊下溢。 若未設定錯誤旗標,則會忽略有問題的函式,而不會有任何副作用。
GL _ _ 記憶體不足 _
沒有足夠的記憶體可執行函式。 在記錄此錯誤之後,不會定義 OpenGL 的狀態,除了錯誤旗標的狀態。

請注意 , _ _ 如果呼叫 GlBegin和其對應的 glEnd呼叫之間呼叫 glGetError,則會傳回 GL 不正確作業。

備註

每個可偵測的錯誤都會被指派一個數位代碼和符號名稱。 發生錯誤時,錯誤旗標會設定為適當的錯誤碼值。 在呼叫 glGetError 之前,不會記錄其他錯誤,會傳回錯誤碼,並將旗標重設為 GL _ 無 _ 錯誤。 如果呼叫 glGetError 時 _ 未 _ 發生錯誤,則在上一次呼叫 GlGetError 之後,或由於 OpenGL 已初始化,即沒有可偵測的錯誤。

若要允許分散式執行,可能會有數個錯誤旗標。 如果有任何單一錯誤旗標已記錄錯誤,則會傳回該旗標的值,並在呼叫 GlGetError 時,將旗標重設為 GL _ 無 _ 錯誤。 如果有一個以上的旗標已記錄錯誤, glGetError 會傳回並清除任意錯誤旗標值。 如果要重設所有錯誤旗標,您應該一律在迴圈中呼叫 glGetError ,直到它傳回 GL _ 沒有錯誤為止 _ 。

一開始,所有錯誤旗標都會設定為 GL _ 無 _ 錯誤。

設定錯誤旗標時,只有當 GL 記憶體不足時,才會定義 OpenGL 作業的結果 _ _ _ 。 在所有其他情況下,會忽略產生錯誤的函式,且不會影響 OpenGL 狀態或畫面格緩衝區內容。

規格需求

需求
最低支援的用戶端
Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
標頭
Gl
程式庫
Opengl32 .lib
DLL
Opengl32.dll

另請參閱

glBegin

glEnd