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)

另请参阅

DrvEnablePDEV