Функция DrvIcmSetDeviceGammaRamp (winddi.h)
Функция DrvIcmSetDeviceGammaRamp задает аппаратную гамма-пандус указанного устройства отображения.
Синтаксис
BOOL DrvIcmSetDeviceGammaRamp(
DHPDEV dhpdev,
ULONG iFormat,
LPVOID lpRamp
);
Параметры
dhpdev
Дескриптор PDEV физического устройства. Это идентифицирует физическое устройство, для которого необходимо установить гамма-пандус.
iFormat
Указывает формат данных буфера, на который указывает lpRamp . Этот параметр всегда IGRF_RGB_256WORDS.
lpRamp
Указатель на буфер, содержащий гамма-пандус для установки на устройстве. Формат данных в этом буфере определяется iFormat.
Если iFormat IGRF_RGB_256WORDS, lpRamp указывает на структуру GAMMARAMP , которая определяет 256 входных пандусов для каждого из каналов красного, синего и зеленого цветов. Каждое значение описывается с использованием 16-разрядной точности. Если оборудование имеет меньше битов точности, оно должно понижать и использовать самые значительные биты без округления.
Возвращаемое значение
DrvIcmSetDeviceGammaRamp возвращает значение TRUE при успешном выполнении. В противном случае возвращается значение FALSE.
Комментарии
Драйверы для устройств отображения с загружаемыми аппаратными гамма-пандусами должны реализовывать эту функцию.
DrvIcmSetDeviceGammaRamp должен завершиться ошибкой, если он вызывается с любым другим значением, кроме IGRF_RGB_256WORDS в iFormat.
Драйвер перехватывает эту функцию, устанавливая флаг GCAPS2_CHANGEGAMMARAMP в поле flGraphicsCaps2 структуры DEVINFO, переданной в DrvEnablePDEV. Если драйвер работает в режиме palettized 8bpp, эта возможность является необязательной.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winddi.h (включая Winddi.h) |