Auf Englisch lesen

Freigeben über


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

Weitere Informationen

OpenGL unter Windows

SetPixelFormat

WGL-Funktionen

wglDeleteContext

wglGetCurrentContext

wglGetCurrentDC

wglMakeCurrent