wglSwapLayerBuffers, fonction (wingdi.h)

Article
08/27/2023

La fonction wglSwapLayerBuffers échange les mémoires tampons avant et arrière dans les plans de superposition, de sous-couche et de main de la fenêtre référencées par un contexte d’appareil spécifié.

Syntaxe

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Paramètres

unnamedParam1

Spécifie le contexte d’appareil d’une fenêtre dont la palette de plan de couche doit être réalisée dans la palette physique.

unnamedParam2

Spécifie les plans de superposition, de sous-couche et de main dont les tampons avant et arrière doivent être échangés. Le membre bReserved de la structure PIXELFORMATDESCRIPTOR spécifie le nombre de plans de superposition et de sous-couche. Le paramètre fuPlanes est une combinaison au niveau du bit des valeurs suivantes.

Valeur	Signification
WGL_SWAP_MAIN_PLANE	Échange les mémoires tampons avant et arrière du plan main.
WGL_SWAP_OVERLAYi	Échange les mémoires tampons avant et arrière du plan de superposition i, où i est un entier compris entre 1 et 15. WGL_SWAP_OVERLAY1 identifie le premier plan de superposition sur le plan de main, WGL_SWAP_OVERLAY2 identifie le deuxième plan de superposition sur le premier plan de superposition, et ainsi de suite.
WGL_SWAP_UNDERLAYi	Échange les mémoires tampons avant et arrière du plan de sous-couche i, où i est un entier compris entre 1 et 15. WGL_SWAP_UNDERLAY1 identifie le premier plan de sous-couche sous le plan de main, WGL_SWAP_UNDERLAY2 identifie le deuxième plan de sous-couche sous le premier plan de sous-couche, et ainsi de suite.

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

Lorsqu’un plan de couche n’inclut pas de mémoire tampon arrière, l’appel de la fonction wglSwapLayerBuffers n’a aucun effet sur ce plan de couche. Après avoir appelé wglSwapLayerBuffers, l’état du contenu de la mémoire tampon arrière est donné dans la structure LAYERPLANEDESCRIPTOR correspondante du plan de couche ou dans la structure PIXELFORMATDESCRIPTOR du plan main. La fonction wglSwapLayerBuffers échange simultanément les mémoires tampons avant et arrière dans les plans de couche spécifiés.

Certains appareils ne prennent pas en charge l’échange de plans de couche individuellement ; ils échangent tous les plans de couche en tant que groupe. Lorsque l’indicateur PFD_SWAP_LAYER_BUFFERS de la structure PIXELFORMATDESCRIPTOR est défini, cela indique qu’un appareil peut échanger des plans de couche individuels et que vous pouvez appeler wglSwapLayerBuffers.

Avec les applications qui utilisent plusieurs threads, avant d’appeler wglSwapLayerBuffers, effacez toutes les commandes de dessin dans tous les threads qui dessinent vers la même fenêtre.

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