wglDeleteContext

  • Article

The wglDeleteContext function deletes a specified OpenGL rendering context.

BOOL wglDeleteContext(
  HGLRC  hglrc   // handle to the OpenGL rendering context to delete
);

Parameters

  • hglrc
    Handle to an OpenGL rendering context that the function will delete.

Return Values

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. To get extended error information, call GetLastError.

Remarks

It is an error to delete an OpenGL rendering context that is the current context of another thread. However, if a rendering context is the calling thread's current context, the wglDeleteContext function changes the rendering context to being not current before deleting it.

The wglDeleteContext function does not delete the device context associated with the OpenGL rendering context when you call the wglMakeCurrent function. After calling wglDeleteContext, you must call DeleteDC to delete the associated device context.

Requirements

**  Windows NT/2000:** Requires Windows NT 3.5 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Declared in wingdi.h.
**  Import Library:** Use opengl32.lib.

See Also

OpenGL on Windows NT, Windows 2000, and Windows 95/98, WGL Functions, DeleteDC, wglCreateContext, wglGetCurrentContext, wglGetCurrentDC, wglMakeCurrent