Función GetDeviceGammaRamp (wingdi.h)

  • Artículo

La función GetDeviceGammaRamp obtiene la rampa gamma en paneles de visualización de color directo que tienen controladores que admiten rampas gamma descargables en hardware.

Importante

Se recomienda encarecidamente no usar esta API. El uso de esta API está sujeto a limitaciones importantes. Consulte SetDeviceGammaRamp para obtener más información.

Sintaxis

BOOL GetDeviceGammaRamp(
  HDC    hdc,
  LPVOID lpRamp
);

Parámetros

hdc

Especifica el contexto del dispositivo de la placa de presentación de color directo en cuestión.

lpRamp

Apunta a un búfer donde la función puede colocar la rampa gamma actual de la placa de visualización de color. La rampa gamma se especifica en tres matrices de 256 elementos WORD cada uno, que contienen la asignación entre valores RGB en el búfer de fotogramas y los valores del convertidor analógico digital (DAC). La secuencia de las matrices es roja, verde y azul.

Valor devuelto

Si esta función se ejecuta correctamente, el valor devuelto es TRUE.

Si se produce un error en esta función, el valor devuelto es FALSE.

Ejemplo

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

Comentarios

Los modos de visualización de color directo no usan tablas de búsqueda de colores y normalmente son de 16, 24 o 32 bits. No todas las placas de vídeo de color directo admiten rampas gamma cargables. GetDeviceGammaRamp solo se realiza correctamente para dispositivos con controladores que admiten rampas gamma descargables en hardware.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también