getDeviceGammaRamp 函数 (wingdi.h)

GetDeviceGammaRamp 函数在具有支持硬件中可下载伽玛渐变的驱动程序的直接彩色显示板上获取伽玛渐变。

重要

强烈建议不要使用此 API。 使用此 API 会受到主要限制。 有关详细信息,请参阅 SetDeviceGammaRamp

语法

BOOL GetDeviceGammaRamp(
  HDC    hdc,
  LPVOID lpRamp
);

参数

hdc

指定有问题的直接彩色显示板的设备上下文。

lpRamp

指向一个缓冲区,函数可在其中放置颜色显示板的当前伽玛渐变。 伽玛渐变在三个数组中指定,每个数组包含 256 个 WORD 元素,这些数组包含帧缓冲区中的 RGB 值与数字模拟转换器 (DAC) 值之间的映射。 数组的序列为红色、绿色、蓝色。

返回值

如果此函数成功,则返回值为 TRUE

如果此函数失败,则返回值为 FALSE

示例

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

注解

直接颜色显示模式不使用颜色查找表,通常为 16、24 或 32 位。 并非所有直接彩色视频板都支持可加载的伽玛渐变。 GetDeviceGammaRamp 仅针对具有支持硬件中可下载伽玛渐变的驱动程序的设备成功。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 wingdi.h
Library Gdi32.lib
DLL Gdi32.dll

另请参阅