Função wglCopyContext (wingdi.h)

Artigo
08/27/2023

A função wglCopyContext copia grupos selecionados de estados de renderização de um contexto de renderização OpenGL para outro.

Sintaxe

BOOL wglCopyContext(
  HGLRC unnamedParam1,
  HGLRC unnamedParam2,
  UINT  unnamedParam3
);

Parâmetros

unnamedParam1

Especifica o contexto de renderização opengl de origem cujas informações de estado devem ser copiadas.

unnamedParam2

Especifica o contexto de renderização opengl de destino para o qual as informações de estado devem ser copiadas.

unnamedParam3

Especifica quais grupos do estado de renderização hglrcSrc devem ser copiados para hglrcDst. Ele contém o OR bit a bit dos mesmos nomes simbólicos que são passados para a função glPushAttrib . Você pode usar GL_ALL_ATTRIB_BITS para copiar todas as informações de estado de renderização.

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE. Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Usando a função wglCopyContext , você pode sincronizar o estado de renderização de dois contextos de renderização. Você só pode copiar o estado de renderização entre dois contextos de renderização dentro do mesmo processo. Os contextos de renderização devem ser da mesma implementação opengl. Por exemplo, você sempre pode copiar um estado de renderização entre dois contextos de renderização com formato de pixel idêntico no mesmo processo.

Você pode copiar as mesmas informações de estado disponíveis apenas com a função glPushAttrib . Não é possível copiar algumas informações de estado, como estado de pacote de pixels/desempacotar, estado do modo de renderização, estado de seleção e estado de comentários. Ao chamar wglCopyContext, verifique se o contexto de renderização de destino, hglrcDst, não é atual para nenhum thread.

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wingdi.h
Biblioteca	Opengl32.lib
DLL	Opengl32.dll