wglShareLists-Funktion (wingdi.h)

Die wglShareLists-Funktion ermöglicht es mehreren OpenGL-Renderingkontexten, einen einzelnen Anzeigelistenbereich gemeinsam zu nutzen.

Syntax

BOOL wglShareLists(
  HGLRC unnamedParam1,
  HGLRC unnamedParam2
);

Parameter

unnamedParam1

Gibt den OpenGL-Renderingkontext an, mit dem Anzeigelisten freigegeben werden sollen.

unnamedParam2

Gibt den OpenGL-Renderingkontext an, um Anzeigelisten mit hglrc1 freizugeben. Der hglrc2-Parameter sollte keine vorhandenen Anzeigelisten enthalten, wenn wglShareLists aufgerufen wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE , und die Anzeigelisten werden nicht freigegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn Sie einen OpenGL-Renderingkontext erstellen, verfügt er über einen eigenen Anzeigelistenbereich. Die wglShareLists-Funktion ermöglicht es einem Renderingkontext, den Anzeigelistenbereich eines anderen Renderingkontexts freizugeben. Eine beliebige Anzahl von Renderingkontexten kann einen einzelnen Anzeigelistenbereich gemeinsam nutzen. Sobald ein Renderingkontext einen Anzeigelistenbereich gemeinsam verwendet, verwendet der Renderingkontext immer den Anzeigelistenbereich, bis der Renderingkontext gelöscht wird. Wenn der letzte Renderingkontext eines freigegebenen Anzeigelistenbereichs gelöscht wird, wird der freigegebene Anzeigelistenbereich gelöscht. Alle Indizes und Definitionen von Anzeigelisten in einem freigegebenen Anzeigelistenbereich werden gemeinsam genutzt.

Sie können Anzeigelisten nur für Renderingkontexte innerhalb desselben Prozesses freigeben. Allerdings können nicht alle Renderingkontexte in einem Prozess Anzeigelisten gemeinsam nutzen. Renderingkontexte können Anzeigelisten nur gemeinsam nutzen, wenn sie dieselbe Implementierung von OpenGL-Funktionen verwenden. Alle Clientrenderkontexte eines bestimmten Pixelformats können immer Anzeigelisten gemeinsam nutzen.

Alle Renderingkontexte einer freigegebenen Anzeigeliste müssen ein identisches Pixelformat verwenden. Andernfalls hängen die Ergebnisse von der verwendeten Implementierung von OpenGL ab.

Hinweis Die wglShareLists-Funktion ist nur mit OpenGL Version 1.01 oder höher verfügbar. Rufen Sie glGetString auf, um die Versionsnummer der Implementierung von OpenGL zu bestimmen.

 

Anforderungen

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

OpenGL unter Windows

WGL-Funktionen

glGetString