Compartilhar via


Função GetDeviceGammaRamp (wingdi.h)

A função GetDeviceGammaRamp obtém a rampa gama em placas de exibição de cores diretas com drivers que dão suporte a rampas gama para download no hardware.

Importante

É altamente recomendável que você não use essa API. O uso dessa API está sujeito a grandes limitações. Consulte SetDeviceGammaRamp para obter mais informações.

Sintaxe

BOOL GetDeviceGammaRamp(
  HDC    hdc,
  LPVOID lpRamp
);

Parâmetros

hdc

Especifica o contexto do dispositivo da placa de exibição de cor direta em questão.

lpRamp

Aponta para um buffer em que a função pode colocar a rampa gama atual da placa de exibição de cor. A rampa gama é especificada em três matrizes de 256 elementos WORD cada, que contêm o mapeamento entre valores RGB nos valores de buffer de quadro e DAC (conversor analógico digital). A sequência das matrizes é vermelha, verde, azul.

Retornar valor

Se essa função for bem-sucedida, o valor retornado será TRUE.

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

Exemplo

WORD gArray[3][256];
GetDeviceGammaRamp(handle, gArray);  
// `handle` is the device context. See GetDC for more details.
// `gArray` will hold the gamma array values in a 2-D array

Comentários

Os modos de exibição de cor direta não usam tabelas de pesquisa de cores e geralmente são de 16, 24 ou 32 bits. Nem todas as placas de vídeo de cor direta dão suporte a rampas gama carregáveis. GetDeviceGammaRamp é bem-sucedido apenas para dispositivos com drivers que dão suporte a rampas gama para download no hardware.

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 Gdi32.lib
DLL Gdi32.dll

Confira também