drvIcmSetDeviceGammaRamp 函数 (winddi.h)
DrvIcmSetDeviceGammaRamp 函数设置指定显示设备的硬件伽玛渐变。
语法
BOOL DrvIcmSetDeviceGammaRamp(
DHPDEV dhpdev,
ULONG iFormat,
LPVOID lpRamp
);
参数
dhpdev
物理设备的 PDEV 的句柄。 这标识要设置其伽玛坡度的物理设备。
iFormat
指定 lpRamp 指向的缓冲区的数据格式。 此参数始终IGRF_RGB_256WORDS。
lpRamp
指向缓冲区的指针，该缓冲区包含要设置在设备上设置的伽玛渐变。 此缓冲区中的数据格式由 iFormat 确定。
IGRF_RGB_256WORDS iFormat 时， lpRamp 指向 GAMMARAMP 结构，该结构定义要为每个红色、蓝色和绿色通道设置的 256 个入口渐变。 每个值都使用 16 位精度进行描述。 如果硬件的精度位较少，则应降级并使用最高有效位，而不舍入。
返回值
DrvIcmSetDeviceGammaRamp 成功后返回 TRUE 。 否则，它将返回 FALSE。
注解
具有可加载硬件伽马坡道的显示设备的驱动程序应实现此功能。
如果 DrvIcmSetDeviceGammaRamp 使用除 iFormat 中的 IGRF_RGB_256WORDS 之外的任何其他值调用，则 DrvIcmSetDeviceGammaRamp 应失败。
驱动程序通过在传递给 DrvEnablePDEV 的 DEVINFO 结构的 flGraphicsCaps2 字段中设置 GCAPS2_CHANGEGAMMARAMP 标志来挂钩此函数。 如果驱动程序在 8bpp 模式下运行，则此功能是可选的。
要求
| 要求 | 值 |
|---|---|
| 目标平台 | 桌面 |
| 标头 | winddi.h (包括 Winddi.h) |