Compartilhar via


Função wglDescribeLayerPlane (wingdi.h)

A função wglDescribeLayerPlane obtém informações sobre os planos de camada de um determinado formato de pixel.

Sintaxe

BOOL wglDescribeLayerPlane(
  HDC                    unnamedParam1,
  int                    unnamedParam2,
  int                    unnamedParam3,
  UINT                   unnamedParam4,
  LPLAYERPLANEDESCRIPTOR unnamedParam5
);

Parâmetros

unnamedParam1

Especifica o contexto do dispositivo de uma janela cujos planos de camada devem ser descritos.

unnamedParam2

Especifica quais planos de camada de um formato de pixel estão sendo descritos.

unnamedParam3

Especifica a sobreposição ou o plano de sobreposição. Os valores positivos de iLayerPlane identificam planos de sobreposição, em que 1 é o primeiro plano de sobreposição sobre o plano main, 2 é o segundo plano de sobreposição sobre o primeiro plano de sobreposição e assim por diante. Valores negativos identificam planos de subposição, em que 1 é o primeiro plano de base sob o plano main, 2 é o segundo plano de sobreposição sob o primeiro plano de sobreposição e assim por diante. O número de planos de sobreposição e de subposição é fornecido no membro bReserved da estrutura PIXELFORMATDESCRIPTOR .

unnamedParam4

Especifica o tamanho, em bytes, da estrutura apontada por plpd. A função wglDescribeLayerPlane armazena dados do plano de camada em uma estrutura LAYERPLANEDESCRIPTOR e armazena não mais do que nBytes de dados. Defina o valor de nBytes como o tamanho de LAYERPLANEDESCRIPTOR.

unnamedParam5

Aponta para uma estrutura LAYERPLANEDESCRIPTOR . A função wglDescribeLayerPlane define o valor dos membros de dados da estrutura. A função armazena o número de bytes de dados copiados para a estrutura no membro nSize .

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE. Além disso, a função wglDescribeLayerPlane define os membros da estrutura LAYERPLANEDESCRIPTOR apontada por plpd de acordo com o plano de camada especificado (iLayerPlane ) do formato de pixel especificado (iPixelFormat ).

Se a função falhar, o valor retornado será FALSE.

Comentários

A numeração de planos (iLayerPlane ) determina sua ordem. Aviões com maior número sobrepõem aviões com menor número.

Requisitos

Requisito Valor
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

Confira também

DescribePixelFormat

LAYERPLANEDESCRIPTOR

OpenGL no Windows

PIXELFORMATDESCRIPTOR

Funções WGL

wglCreateLayerContext