Función wglCreateContext (wingdi.h)

Artículo
03/13/2024

La función wglCreateContext crea un nuevo contexto de representación de OpenGL, que es adecuado para dibujar en el dispositivo al que hace referencia hdc. El contexto de representación tiene el mismo formato de píxel que el contexto del dispositivo.

Sintaxis

HGLRC wglCreateContext(
  HDC unnamedParam1
);

Parámetros

unnamedParam1

Normalmente, se denomina handleToDeviceContext. Controlar en un contexto de dispositivo para el que la función crea un contexto de representación de OpenGL adecuado.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es un identificador válido para un contexto de representación de OpenGL.

Si la función no se realiza correctamente, el valor devuelto es NULL. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Un contexto de representación no es el mismo que un contexto de dispositivo. Establezca el formato de píxel del contexto del dispositivo antes de crear un contexto de representación. Para obtener más información sobre cómo establecer el formato de píxel del contexto del dispositivo, consulte la función SetPixelFormat .

Para usar OpenGL, cree un contexto de representación, selecciónelo como contexto de representación actual de un subproceso y, a continuación, llame a funciones de OpenGL. Cuando haya terminado con el contexto de representación, lo elimine llamando a la función wglDeleteContext .

En el ejemplo de código siguiente se muestra el uso 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);

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wingdi.h
Library	Opengl32.lib
Archivo DLL	Opengl32.dll