Función wglSwapLayerBuffers (wingdi.h)

La función wglSwapLayerBuffers intercambia los búferes frontales y traseros de la superposición, la subposición y los planos principales de la ventana a la que hace referencia un contexto de dispositivo especificado.

Sintaxis

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Parámetros

unnamedParam1

Especifica el contexto del dispositivo de una ventana cuya paleta de plano de capa se va a realizar en la paleta física.

unnamedParam2

Especifica la superposición, la subposición y los planos principales cuyos búferes delanteros y traseros se van a intercambiar. El miembro bReserved de la estructura PIXELFORMATDESCRIPTOR especifica el número de planos de superposición y subposición. El parámetro fuPlanes es una combinación bit a bit de los valores siguientes.

 

Value	Significado
WGL_SWAP_MAIN_PLANE	Intercambia los búferes frontal y trasero del plano principal.
WGL_SWAP_OVERLAYi	Intercambia los búferes frontal y trasero del plano de superposición i, donde i es un entero entre 1 y 15. WGL_SWAP_OVERLAY1 identifica el primer plano de superposición sobre el plano principal, WGL_SWAP_OVERLAY2 identifica el segundo plano de superposición sobre el primer plano de superposición, etc.
WGL_SWAP_UNDERLAYi	Intercambia los búferes delanteros y traseros del plano subyacente i, donde i es un entero entre 1 y 15. WGL_SWAP_UNDERLAY1 identifica el primer plano subyacente bajo el plano principal, WGL_SWAP_UNDERLAY2 identifica el segundo plano subyacente bajo el primer plano subyacente, etc.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE. Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Cuando un plano de capa no incluye un búfer de reserva, llamar a la función wglSwapLayerBuffers no tiene ningún efecto en ese plano de capa. Después de llamar a wglSwapLayerBuffers, el estado del contenido del búfer de reserva se da en la estructura LAYERPLANEDESCRIPTOR correspondiente del plano de capa o en la estructura PIXELFORMATDESCRIPTOR del plano principal. La función wglSwapLayerBuffers intercambia los búferes delanteros y traseros en los planos de capa especificados simultáneamente.

Algunos dispositivos no admiten el intercambio individual de planos de capa; intercambian todos los planos de capa como un grupo. Cuando se establece la marca PFD_SWAP_LAYER_BUFFERS de la estructura PIXELFORMATDESCRIPTOR , indica que un dispositivo puede intercambiar planos de capa individuales y que puede llamar a wglSwapLayerBuffers.

Con las aplicaciones que usan varios subprocesos, antes de llamar a wglSwapLayerBuffers, borre todos los comandos de dibujo de todos los subprocesos que se dibujan en la misma ventana.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h
Library	Opengl32.lib
Archivo DLL	Opengl32.dll

Consulte también

LAYERPLANEDESCRIPTOR

OpenGL en Windows

PIXELFORMATDESCRIPTOR

SwapBuffers

Funciones WGL