Função wglSwapLayerBuffers (wingdi.h)

A função wglSwapLayerBuffers troca os buffers frontal e traseiro nos planos de sobreposição, subposição e main da janela referenciada por um contexto de dispositivo especificado.

Sintaxe

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Parâmetros

unnamedParam1

Especifica o contexto do dispositivo de uma janela cuja paleta de planos de camada deve ser realizada na paleta física.

unnamedParam2

Especifica a sobreposição, a sobreposição e main planos cujos buffers frontal e traseiro devem ser trocados. O membro bReserved da estrutura PIXELFORMATDESCRIPTOR especifica o número de planos de sobreposição e de subposição. O parâmetro fuPlanes é uma combinação bit a bit dos valores a seguir.

 

Valor	Significado
WGL_SWAP_MAIN_PLANE	Troca os buffers frontal e traseiro do plano main.
WGL_SWAP_OVERLAYi	Troca os buffers frontal e traseiro do plano de sobreposição i, em que i é um inteiro entre 1 e 15. WGL_SWAP_OVERLAY1 identifica o primeiro plano de sobreposição sobre o plano main, WGL_SWAP_OVERLAY2 identifica o segundo plano de sobreposição sobre o primeiro plano de sobreposição e assim por diante.
WGL_SWAP_UNDERLAYi	Troca os buffers frontal e traseiro do plano de sobreposição i, em que i é um inteiro entre 1 e 15. WGL_SWAP_UNDERLAY1 identifica o primeiro plano de sobreposição sob o plano main, WGL_SWAP_UNDERLAY2 identifica o segundo plano de sobreposição sob o primeiro plano de sobreposição e assim por diante.

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE. Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Quando um plano de camada não inclui um buffer de fundo, chamar a função wglSwapLayerBuffers não tem efeito nesse plano de camada. Depois de chamar wglSwapLayerBuffers, o estado do conteúdo do buffer de fundo é fornecido na estrutura LAYERPLANEDESCRIPTOR correspondente do plano de camada ou na estrutura PIXELFORMATDESCRIPTOR do plano main. A função wglSwapLayerBuffers troca os buffers frontal e traseiro nos planos de camada especificados simultaneamente.

Alguns dispositivos não dão suporte à troca de planos de camada individualmente; trocam todos os planos de camada como um grupo. Quando o sinalizador PFD_SWAP_LAYER_BUFFERS da estrutura PIXELFORMATDESCRIPTOR é definido, ele indica que um dispositivo pode trocar planos de camada individuais e que você pode chamar wglSwapLayerBuffers.

Com aplicativos que usam vários threads, antes de chamar wglSwapLayerBuffers, limpe todos os comandos de desenho em todos os threads desenhando para a mesma janela.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll

Confira também

LAYERPLANEDESCRIPTOR

OpenGL no Windows

PIXELFORMATDESCRIPTOR

SwapBuffers

Funções WGL