fonction wglCreateContext (wingdi.h)

Article
03/13/2024

La fonction wglCreateContext crée un nouveau contexte de rendu OpenGL, qui convient pour dessiner sur l’appareil référencé par hdc. Le contexte de rendu a le même format de pixels que le contexte de l’appareil.

Syntaxe

HGLRC wglCreateContext(
  HDC unnamedParam1
);

Paramètres

unnamedParam1

Généralement nommé handleToDeviceContext. Gérez vers un contexte d’appareil pour lequel la fonction crée un contexte de rendu OpenGL approprié.

Valeur retournée

Si la fonction réussit, la valeur de retour est un handle valide pour un contexte de rendu OpenGL.

Si la fonction échoue, la valeur de retour est NULL. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Un contexte de rendu n’est pas identique à un contexte d’appareil. Définissez le format de pixels du contexte de l’appareil avant de créer un contexte de rendu. Pour plus d’informations sur la définition du format de pixels du contexte d’appareil, consultez la fonction SetPixelFormat .

Pour utiliser OpenGL, vous créez un contexte de rendu, sélectionnez-le comme contexte de rendu actuel d’un thread, puis appelez des fonctions OpenGL. Lorsque vous avez terminé avec le contexte de rendu, vous en éliminez en appelant la fonction wglDeleteContext .

L’exemple de code suivant montre l’utilisation de 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);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wingdi.h
Bibliothèque	Opengl32.lib
DLL	Opengl32.dll