funzione wglSwapLayerBuffers (wingdi.h)

Articolo
08/27/2023

La funzione wglSwapLayerBuffers scambia i buffer front-and back nella sovrapposizione, sottolay e piani principali della finestra a cui fa riferimento un contesto di dispositivo specificato.

Sintassi

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Parametri

unnamedParam1

Specifica il contesto del dispositivo di una finestra il cui tavolozza piano livello deve essere realizzato nella tavolozza fisica.

unnamedParam2

Specifica la sovrapposizione, la sottolay e i piani principali i cui buffer front-end e indietro devono essere scambiati. Il membro bReserved della struttura PIXELFORMATDESCRIPTOR specifica il numero di piani di sovrapposizione e sottolay. Il parametro fuPlanes è una combinazione bit per bit dei valori seguenti.

Valore	Significato
WGL_SWAP_MAIN_PLANE	Scambia i buffer front-back del piano principale.
WGL_SWAP_OVERLAYi	Scambia i buffer front-back del piano di sovrapposizione i, dove i è un intero compreso tra 1 e 15. WGL_SWAP_OVERLAY1 identifica il primo piano di sovrapposizione sul piano principale, WGL_SWAP_OVERLAY2 identifica il secondo piano di sovrapposizione sul primo piano di sovrapposizione e così via.
WGL_SWAP_UNDERLAYi	Scambia i buffer front-back del piano underlay i, dove i è un intero compreso tra 1 e 15. WGL_SWAP_UNDERLAY1 identifica il primo piano sotto il piano principale, WGL_SWAP_UNDERLAY2 identifica il secondo piano sotto il primo piano sottolay e così via.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Quando un piano di livello non include un buffer indietro, la chiamata alla funzione wglSwapLayerBuffers non ha alcun effetto sul piano di livello. Dopo aver chiamato wglSwapLayerBuffers, lo stato del contenuto del buffer indietro viene specificato nella struttura LAYERPLANEDESCRIPTOR corrispondente del piano di livello o nella struttura PIXELFORMATDESCRIPTOR del piano principale. La funzione wglSwapLayerBuffers scambia contemporaneamente i buffer front-and back nei piani di livello specificati.

Alcuni dispositivi non supportano lo scambio di piani di livello singolarmente; scambiano tutti i piani di livello come gruppo. Quando viene impostato il flag PFD_SWAP_LAYER_BUFFERS della struttura PIXELFORMATDESCRIPTOR , indica che un dispositivo può scambiare singoli piani di livello e che è possibile chiamare wglSwapLayerBuffers.

Con le applicazioni che usano più thread, prima di chiamare wglSwapLayerBuffers, deselezionare tutti i comandi di disegno in tutti i thread che disegnano nella stessa finestra.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wingdi.h
Libreria	Opengl32.lib
DLL	Opengl32.dll

Vedi anche

LAYERPLANEDESCRIPTOR

OpenGL in Windows

PIXELFORMATDESCRIPTOR

SwapBuffers

Funzioni WGL

Condividi tramite