wglSwapLayerBuffers, fonction (wingdi.h)

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 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

Voir aussi

LAYERPLANEDESCRIPTOR

OpenGL sur Windows

PIXELFORMATDESCRIPTOR

SwapBuffers

Fonctions WGL