wglCopyContext-Funktion (wingdi.h)
Die wglCopyContext-Funktion kopiert ausgewählte Gruppen von Renderingzuständen aus einem OpenGL-Renderingkontext in einen anderen.
Syntax
BOOL wglCopyContext(
HGLRC unnamedParam1,
HGLRC unnamedParam2,
UINT unnamedParam3
);
Parameter
unnamedParam1
Gibt den Quell-OpenGL-Renderingkontext an, dessen Zustandsinformationen kopiert werden sollen.
unnamedParam2
Gibt den Ziel-OpenGL-Renderingkontext an, in den Zustandsinformationen kopiert werden sollen.
unnamedParam3
Gibt an, welche Gruppen des hglrcSrc-Renderingzustands in hglrcDst kopiert werden sollen. Sie enthält den bitweisen OR der gleichen symbolischen Namen, die an die funktion glPushAttrib übergeben werden. Sie können GL_ALL_ATTRIB_BITS verwenden, um alle Renderingstatusinformationen zu kopieren.
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
Mit der wglCopyContext-Funktion können Sie den Renderingzustand von zwei Renderingkontexten synchronisieren. Sie können den Renderingzustand nur zwischen zwei Renderingkontexten innerhalb desselben Prozesses kopieren. Die Renderingkontexte müssen aus derselben OpenGL-Implementierung stammen. Beispielsweise können Sie im selben Prozess immer einen Renderingzustand zwischen zwei Renderingkontexten mit identischem Pixelformat kopieren.
Sie können dieselben Zustandsinformationen kopieren, die nur mit der Funktion glPushAttrib verfügbar sind. Sie können einige Statusinformationen nicht kopieren, z. B. Pixelpack-/Entpackzustand, Rendermoduszustand, Auswählen des Zustands und Feedbackstatus. Wenn Sie wglCopyContext aufrufen, stellen Sie sicher, dass der Zielrenderkontext hglrcDst für keinen Thread aktuell ist.
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 |