glGetString fonction)

La fonction glGetString retourne une chaîne décrivant la connexion OpenGL actuelle.

Syntaxe

const GLubyte* WINAPI glGetString(
   GLenum name
);

Paramètres

name

L’une des constantes symboliques suivantes.

Valeur Signification
fournisseur du GL _
Retourne la société responsable de cette implémentation OpenGL. Ce nom ne passe pas de Release à Release.
_convertisseur GL
Retourne le nom du convertisseur. Ce nom est généralement spécifique à une configuration particulière d’une plateforme matérielle. Il ne passe pas de Release à Release.
VERSION du GL _
Retourne un numéro de version ou de version.
EXTENSIONS du GL _
Retourne une liste séparée par des espaces des extensions prises en charge par OpenGL.

Codes d’erreur

Les codes d’erreur suivants peuvent être récupérés par la fonction glGetError .

Nom Signification
_enum GL non valide _
le nom n’est pas une valeur acceptée.
_opération non valide du GL _
La fonction a été appelée entre un appel à glBegin et l’appel correspondant à glEnd.

Notes

La fonction glGetString retourne un pointeur vers une chaîne statique décrivant certains aspects de la connexion OpenGL actuelle.

Comme OpenGL n’inclut pas de requêtes pour les caractéristiques de performances d’une implémentation, il est prévu que certaines applications soient écrites pour reconnaître les plateformes connues et modifient leur utilisation de OpenGL en fonction des caractéristiques de performances connues de ces plateformes. Les chaînes fournisseur du GL _ et _ convertisseur GL regroupent de façon unique une plateforme, et ne changent pas d’une version à l’autres. Ils doivent être utilisés en tant que tels par les algorithmes de reconnaissance de plateforme.

Le format et le contenu de la chaîne retournée par glGetString dépendent de l’implémentation, à l’exception de :

  • Les noms d’extension n’incluent pas de caractères d’espace et seront séparés par des espaces dans la _ chaîne d’extensions GL.

  • La chaîne de version du GL _ commence par un numéro de version. Le numéro de version utilise l’une des formes suivantes :

    _ nombre majeur. _ nombre mineur

    _ nombre majeur. _ nombre mineur. _ numéro de version

  • Les informations spécifiques au fournisseur peuvent suivre le numéro de version. Son format dépend de l’implémentation, mais un espace sépare toujours le numéro de version et les informations spécifiques au fournisseur.

  • Toutes les chaînes se terminent par un caractère null.

Si une erreur est générée, glGetString retourne zéro.

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
GL. h
Bibliothèque
Opengl32. lib
DLL
Opengl32.dll

Voir aussi

glBegin

glEnd