Função DrvIcmSetDeviceGammaRamp (winddi.h)

A função DrvIcmSetDeviceGammaRamp define a rampa de gama de hardware do dispositivo de exibição especificado.

Sintaxe

BOOL DrvIcmSetDeviceGammaRamp(
  DHPDEV dhpdev,
  ULONG  iFormat,
  LPVOID lpRamp
);

Parâmetros

dhpdev

Manipule para o PDEV do dispositivo físico. Isso identifica o dispositivo físico cuja rampa gama deve ser definida.

iFormat

Especifica o formato de dados do buffer para o qual o lpRamp aponta. Esse parâmetro é sempre IGRF_RGB_256WORDS.

lpRamp

Ponteiro para o buffer que contém a rampa gama a ser definida no dispositivo. O formato dos dados nesse buffer é determinado pelo iFormat.

Quando iFormat é IGRF_RGB_256WORDS, lpRamp aponta para uma estrutura GAMMARAMP que define as rampas de 256 entradas a serem definidas para cada um dos canais de cores vermelho, azul e verde. Cada valor é descrito usando a precisão de 16 bits. Se o hardware tiver menos bits de precisão, ele deverá ser reduzido e usar os bits mais significativos, sem arredondamento.

Retornar valor

DrvIcmSetDeviceGammaRamp retorna TRUE após o sucesso. Caso contrário, retornará FALSE.

Comentários

Os drivers para dispositivos de exibição com rampas de gama de hardware carregáveis devem implementar essa função.

DrvIcmSetDeviceGammaRamp deverá falhar se for chamado com qualquer outro valor além de IGRF_RGB_256WORDS no iFormat.

O driver conecta essa função definindo o sinalizador GCAPS2_CHANGEGAMMARAMP no campo flGraphicsCaps2 da estrutura DEVINFO passada para DrvEnablePDEV. Se o driver estiver em execução em um modo 8bpp palettizado, essa funcionalidade será opcional.

Requisitos

Confira também

DrvEnablePDEV