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 |