wglCreateContext 函数 (wingdi.h)

项目
03/04/2024

wglCreateContext 函数创建一个新的 OpenGL 呈现上下文，该上下文适用于在 hdc 引用的设备上绘图。呈现上下文具有与设备上下文相同的像素格式。

语法

HGLRC wglCreateContext(
  HDC unnamedParam1
);

参数

unnamedParam1

通常命名为 handleToDeviceContext。函数为其创建合适的 OpenGL 呈现上下文的设备上下文的句柄。

返回值

如果函数成功，则返回值是 OpenGL 呈现上下文的有效句柄。

如果函数失败，则返回值为 NULL。要获得更多的错误信息，请调用 GetLastError。

注解

呈现上下文与设备上下文不同。在创建呈现上下文之前设置设备上下文的像素格式。有关设置设备上下文的像素格式的详细信息，请参阅 SetPixelFormat 函数。

若要使用 OpenGL，请创建呈现上下文，将其选择为线程的当前呈现上下文，然后调用 OpenGL 函数。完成呈现上下文后，可以通过调用 wglDeleteContext 函数来释放它。

下面的代码示例演示 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);

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h
Library	Opengl32.lib
DLL	Opengl32.dll