Функция DrvSetPalette (winddi.h)
Функция DrvSetPalette запрашивает, чтобы драйвер реализовал палитру для указанного устройства.
Синтаксис
BOOL DrvSetPalette(
DHPDEV dhpdev,
PALOBJ *ppalo,
FLONG fl,
ULONG iStart,
ULONG cColors
);
Параметры
dhpdev
Дескриптор структуры PDEV физического устройства, которая определяет устройство, палитра которого должна быть реализована. Этот параметр является дескриптором устройства, возвращенным в GDI drvEnablePDEV.
ppalo
Указатель на структуру PALOBJ , из которой следует запрашивать цвета (значения RGB).
fl
Набор флагов, предоставляющий указания и параметры. Этот параметр может иметь следующее значение:
| Значение | Значение |
|---|---|
| SP_DEFAULT | Палитра — это полная палитра устройства по умолчанию. PALOBJ можно игнорировать, но содержит правильное содержимое. |
iStart
Указывает первый индекс палитры для перезаписи.
cColors
Указывает количество цветов для изменения в аппаратной палитре. Дополнительные цвета, помимо количества доступных в оборудовании, можно игнорировать. Если размер cColors меньше размера аппаратной палитры, задайте только записи cColors и оставьте остальные цвета без изменений.
Возвращаемое значение
Возвращаемое значение равно TRUE , если функция выполнена успешно. В противном случае это значение false, а код ошибки записывается в журнал.
Комментарии
Драйвер задает аппаратной палитре максимально точное соответствие записям в заданной палитре.
Доступны только индексированные палитры. Бит RC_PALETTE элемента flRasterCaps структуры GDIINFO указывает, имеет ли устройство реализуемую палитру.
DrvSetPalette требуется для драйверов дисплея, поддерживающих реализуемые палитры.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | winddi.h (включая Winddi.h) |