wglSwapLayerBuffers-Funktion (wingdi.h)

Die wglSwapLayerBuffers-Funktion tauscht die Vorder- und Rückseitenpuffer in den Überlagerungs-, Unterlage- und Standard Ebenen des Fensters, auf die von einem angegebenen Gerätekontext verwiesen wird.

Syntax

BOOL wglSwapLayerBuffers(
  HDC  unnamedParam1,
  UINT unnamedParam2
);

Parameter

unnamedParam1

Gibt den Gerätekontext eines Fensters an, dessen Ebenenpalette in der physischen Palette realisiert werden soll.

unnamedParam2

Gibt die Überlagerungs-, Unterlage- und Standard-Ebenen an, deren Front- und Backpuffer ausgetauscht werden sollen. Das bReserved-Element der PIXELFORMATDESCRIPTOR-Struktur gibt die Anzahl der Überlagerungs- und Unterschichtebenen an. Der fuPlanes-Parameter ist eine bitweise Kombination der folgenden Werte.

 

Wert	Bedeutung
WGL_SWAP_MAIN_PLANE	Tauscht die Vorder- und Rückseitenpuffer der Standard Ebene aus.
WGL_SWAP_OVERLAYi	Wechselt die Vorder- und Rückseitenpuffer der Überlagerungsebene i, wobei i eine ganze Zahl zwischen 1 und 15 ist. WGL_SWAP_OVERLAY1 die erste Überlagerungsebene über der Standard-Ebene identifiziert, identifiziert WGL_SWAP_OVERLAY2 die zweite Überlagerungsebene über der ersten Überlagerungsebene usw.
WGL_SWAP_UNDERLAYi	Tauscht die Vorder- und Rückseitenpuffer der Unterlageebene i, wobei i eine ganze Zahl zwischen 1 und 15 ist. WGL_SWAP_UNDERLAY1 die erste Unterlageebene unter der Standard-Ebene identifiziert, identifiziert WGL_SWAP_UNDERLAY2 die zweite Unterlageebene unter der ersten Unterlageebene usw.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE. Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn eine Ebenenebene keinen Backpuffer enthält, hat das Aufrufen der wglSwapLayerBuffers-Funktion keine Auswirkungen auf diese Ebenenebene. Nachdem Sie wglSwapLayerBuffers aufgerufen haben, wird der Zustand des Backpufferinhalts in der entsprechenden LAYERPLANEDESCRIPTOR-Struktur der Ebenenebene oder in der PIXELFORMATDESCRIPTOR-Struktur der Standard Ebene angegeben. Die wglSwapLayerBuffers-Funktion tauscht gleichzeitig die Front- und Back-Puffer in den angegebenen Ebenen aus.

Einige Geräte unterstützen den Austausch von Ebenenebenen nicht einzeln. Sie tauschen alle Ebenen als Gruppe aus. Wenn das PFD_SWAP_LAYER_BUFFERS-Flag der PIXELFORMATDESCRIPTOR-Struktur festgelegt ist, gibt dies an, dass ein Gerät einzelne Ebenen austauschen kann und dass Sie wglSwapLayerBuffers aufrufen können.

Löschen Sie bei Anwendungen, die mehrere Threads verwenden, vor dem Aufrufen von wglSwapLayerBuffers alle Zeichnungsbefehle in allen Threads, die im selben Fenster zeichnen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wingdi.h
Bibliothek	Opengl32.lib
DLL	Opengl32.dll

Weitere Informationen

LAYERPLANEDESCRIPTOR

OpenGL unter Windows

PIXELFORMATDESCRIPTOR

SwapBuffer

WGL-Funktionen