wglCopyContext, fonction (wingdi.h)

Article
08/27/2023

La fonction wglCopyContext copie les groupes d’états de rendu sélectionnés d’un contexte de rendu OpenGL vers un autre.

Syntaxe

BOOL wglCopyContext(
  HGLRC unnamedParam1,
  HGLRC unnamedParam2,
  UINT  unnamedParam3
);

Paramètres

unnamedParam1

Spécifie le contexte de rendu OpenGL source dont les informations d’état doivent être copiées.

unnamedParam2

Spécifie le contexte de rendu OpenGL de destination dans lequel les informations d’état doivent être copiées.

unnamedParam3

Spécifie les groupes de l’état de rendu hglrcSrcs à copier dans hglrcDst. Il contient le bit-OR des mêmes noms symboliques qui sont passés à la fonction glPushAttrib . Vous pouvez utiliser GL_ALL_ATTRIB_BITS pour copier toutes les informations d’état de rendu.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

À l’aide de la fonction wglCopyContext , vous pouvez synchroniser l’état de rendu de deux contextes de rendu. Vous ne pouvez copier l’état de rendu qu’entre deux contextes de rendu au sein du même processus. Les contextes de rendu doivent provenir de la même implémentation OpenGL. Par exemple, vous pouvez toujours copier un état de rendu entre deux contextes de rendu au format de pixel identique dans le même processus.

Vous pouvez copier les mêmes informations d’état disponibles qu’avec la fonction glPushAttrib . Vous ne pouvez pas copier certaines informations d’état, telles que l’état du pack de pixels/décompression, l’état du mode de rendu, l’état de sélection et l’état de commentaires. Lorsque vous appelez wglCopyContext, assurez-vous que le contexte de rendu de destination, hglrcDst, n’est pas à jour pour un thread.

Configuration requise


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