fonction glGetError
La fonction glGetError retourne des informations d’erreur.
Syntaxe
GLenum WINAPI glGetError(void);
Paramètres
Cette fonction n’a pas de paramètres.
Valeur retournée
La fonction glGetError retourne l’un des codes d’erreur suivants.
| Code de retour | Description |
|---|---|
|
Une valeur inacceptable est spécifiée pour un argument énuméré. La fonction incriminée est ignorée, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur. |
|
Un argument numérique est hors de portée. La fonction incriminée est ignorée, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur. |
|
L’opération spécifiée n’est pas autorisée dans l’état actuel. La fonction incriminée est ignorée, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur. |
|
Aucune erreur n’a été enregistrée. La valeur de cette constante symbolique est garantie de zéro. |
|
Cette fonction provoquerait un dépassement de capacité de la pile. La fonction incriminée est ignorée, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur. |
|
Cette fonction provoquerait un sous-flux de pile. La fonction incriminée est ignorée, n’ayant aucun effet secondaire autre que de définir l’indicateur d’erreur. |
|
Il ne reste pas assez de mémoire pour exécuter la fonction. L’état d’OpenGL n’est pas défini, à l’exception de l’état des indicateurs d’erreur, une fois cette erreur enregistrée. |
Notez que glGetError retourne GL_INVALID_OPERATION s’il est appelé entre un appel à glBegin et son appel à glEnd correspondant.
Notes
Chaque erreur détectable se voit attribuer un code numérique et un nom symbolique. Lorsqu’une erreur se produit, l’indicateur d’erreur est défini sur la valeur de code d’erreur appropriée. Aucune autre erreur n’est enregistrée tant que glGetError n’est pas appelé, que le code d’erreur est retourné et que l’indicateur est réinitialisé à GL_NO_ERROR. Si un appel à glGetError retourne GL_NO_ERROR, il n’y a pas eu d’erreur détectable depuis le dernier appel à glGetError ou depuis l’initialisation d’OpenGL.
Pour autoriser les implémentations distribuées, il peut y avoir plusieurs indicateurs d’erreur. Si un indicateur d’erreur unique a enregistré une erreur, la valeur de cet indicateur est retournée et cet indicateur est réinitialisé à GL_NO_ERROR lorsque glGetError est appelé. Si plusieurs indicateurs ont enregistré une erreur, glGetError retourne et efface une valeur d’indicateur d’erreur arbitraire. Si tous les indicateurs d’erreur doivent être réinitialisés, vous devez toujours appeler glGetError dans une boucle jusqu’à ce qu’il retourne GL_NO_ERROR.
Initialement, tous les indicateurs d’erreur sont définis sur GL_NO_ERROR.
Lorsqu’un indicateur d’erreur est défini, les résultats d’une opération OpenGL ne sont définis que si GL_OUT_OF_MEMORY s’est produit. Dans tous les autres cas, la fonction qui génère l’erreur est ignorée et n’a aucun effet sur l’état OpenGL ou le contenu de framebuffer.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows 2000 Server [applications de bureau uniquement] |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|