wglCreateContext 函数 (wingdi.h)

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

另请参阅

Windows 上的 OpenGL

SetPixelFormat

WGL 函数

wglDeleteContext

wglGetCurrentContext

wglGetCurrentDC

wglMakeCurrent