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.
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 |