fonction wglShareLists (wingdi.h)

La fonction wglShareLists permet à plusieurs contextes de rendu OpenGL de partager un seul espace de liste d’affichage.

Syntaxe

BOOL wglShareLists(
  HGLRC unnamedParam1,
  HGLRC unnamedParam2
);

Paramètres

unnamedParam1

Spécifie le contexte de rendu OpenGL avec lequel partager des listes d’affichage.

unnamedParam2

Spécifie le contexte de rendu OpenGL pour partager des listes d’affichage avec hglrc1. Le paramètre hglrc2 ne doit pas contenir de listes d’affichage existantes lorsque wglShareLists est appelé.

Valeur retournée

Lorsque la fonction réussit, la valeur de retour est TRUE.

En cas d’échec de la fonction, la valeur de retour est FALSE et les listes d’affichage ne sont pas partagées. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Lorsque vous créez un contexte de rendu OpenGL, il dispose de son propre espace de liste d’affichage. La fonction wglShareLists permet à un contexte de rendu de partager l’espace de liste d’affichage d’un autre contexte de rendu ; n’importe quel nombre de contextes de rendu peuvent partager un seul espace de liste d’affichage. Une fois qu’un contexte de rendu partage un espace de liste d’affichage, le contexte de rendu utilise toujours l’espace de liste d’affichage jusqu’à ce que le contexte de rendu soit supprimé. Lorsque le dernier contexte de rendu d’un espace de liste d’affichage partagé est supprimé, l’espace de liste d’affichage partagé est supprimé. Tous les index et définitions des listes d’affichage dans un espace de liste d’affichage partagé sont partagés.

Vous pouvez uniquement partager des listes d’affichage avec des contextes de rendu au sein du même processus. Toutefois, tous les contextes de rendu d’un processus peuvent partager des listes d’affichage. Les contextes de rendu ne peuvent partager des listes d’affichage que s’ils utilisent la même implémentation de fonctions OpenGL. Tous les contextes de rendu client d’un format de pixel donné peuvent toujours partager des listes d’affichage.

Tous les contextes de rendu d’une liste d’affichage partagée doivent utiliser un format de pixel identique. Sinon, les résultats dépendent de l’implémentation d’OpenGL utilisée.

Note La fonction wglShareLists n’est disponible qu’avec OpenGL version 1.01 ou ultérieure. Pour déterminer le numéro de version de l’implémentation d’OpenGL, appelez glGetString.

 

Configuration requise

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]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll

Voir aussi

OpenGL sur Windows

Fonctions WGL

glGetString