wglCreateContext-Funktion (wingdi.h)
Die wglCreateContext-Funktion erstellt einen neuen OpenGL-Renderingkontext, der zum Zeichnen auf dem Gerät geeignet ist, auf das von hdc verwiesen wird. Der Renderingkontext hat das gleiche Pixelformat wie der Gerätekontext.
Syntax
HGLRC wglCreateContext(
HDC unnamedParam1
);
Parameter
unnamedParam1
In der Regel mit dem Namen handleToDeviceContext
. Handle mit einem Gerätekontext, für den die Funktion einen geeigneten OpenGL-Renderingkontext erstellt.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein gültiges Handle für einen OpenGL-Renderingkontext.
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Ein Renderingkontext ist nicht mit einem Gerätekontext identisch. Legen Sie das Pixelformat des Gerätekontexts fest, bevor Sie einen Renderingkontext erstellen. Weitere Informationen zum Festlegen des Pixelformats des Gerätekontexts finden Sie in der SetPixelFormat-Funktion .
Um OpenGL zu verwenden, erstellen Sie einen Renderingkontext, wählen ihn als aktuellen Renderingkontext eines Threads aus, und rufen dann OpenGL-Funktionen auf. Wenn Sie mit dem Renderingkontext fertig sind, löschen Sie ihn, indem Sie die Funktion wglDeleteContext aufrufen.
Das folgende Codebeispiel zeigt die Verwendung von wglCreateContext .
HDC hdc;
HGLRC hglrc;
// create a rendering context
hglrc = wglCreateContext (hdc);
// make it the calling thread's current rendering context
wglMakeCurrent (hdc, hglrc);
// call OpenGL APIs as desired ...
// when the rendering context is no longer needed ...
// make the rendering context not current
wglMakeCurrent (NULL, NULL) ;
// delete the rendering context
wglDeleteContext (hglrc);
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 |