Función wglMakeCurrent (wingdi.h)

Artículo
08/27/2023

La función wglMakeCurrent convierte un contexto de representación de OpenGL especificado en el contexto de representación actual del subproceso que realiza la llamada. Todas las llamadas OpenGL posteriores realizadas por el subproceso se dibujan en el dispositivo identificado por hdc. También puede usar wglMakeCurrent para cambiar el contexto de representación actual del subproceso que realiza la llamada para que ya no sea actual.

Sintaxis

BOOL wglMakeCurrent(
  HDC   unnamedParam1,
  HGLRC unnamedParam2
);

Parámetros

unnamedParam1

Identificador de un contexto de dispositivo. Las llamadas OpenGL posteriores realizadas por el subproceso de llamada se dibujan en el dispositivo identificado por hdc.

unnamedParam2

Controle un contexto de representación de OpenGL que la función establece como contexto de representación del subproceso que realiza la llamada.

Si hglrc es NULL, la función hace que el contexto de representación actual del subproceso de llamada ya no esté activo y libera el contexto de dispositivo que usa el contexto de representación. En este caso, se omite hdc .

Valor devuelto

Cuando la función wglMakeCurrent se realiza correctamente, el valor devuelto es TRUE; de lo contrario, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

El parámetro hdc debe hacer referencia a una superficie de dibujo compatible con OpenGL. No es necesario que sea el mismo hdc que se pasó a wglCreateContext cuando se creó hglrc , pero debe estar en el mismo dispositivo y tener el mismo formato de píxel. El contexto de representación no admite la transformación y el recorte de GDI en hdc . El contexto de representación actual usa el contexto del dispositivo hdc hasta que el contexto de representación ya no esté activo.

Antes de cambiar al nuevo contexto de representación, OpenGL vacía cualquier contexto de representación anterior actual al subproceso que realiza la llamada.

Un subproceso puede tener un contexto de representación actual. Un proceso puede tener varios contextos de representación mediante multithreading. Un subproceso debe establecer un contexto de representación actual antes de llamar a cualquier función de OpenGL. De lo contrario, se omiten todas las llamadas de OpenGL.

Un contexto de representación puede ser actual solo a un subproceso a la vez. No se puede establecer un contexto de representación actual en varios subprocesos.

Una aplicación puede realizar un dibujo multiproceso haciendo diferentes contextos de representación actuales a diferentes subprocesos, proporcionando cada subproceso con su propio contexto de representación y contexto de dispositivo.

Si se produce un error, la función wglMakeCurrent hace que el contexto de representación actual del subproceso no sea actual antes de devolverlo.

Requisitos


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