функция XLATEOBJ_cGetPalette (winddi.h)

Функция XLATEOBJ_cGetPalette извлекает цвета RGB или формат битовых полей из указанной палитры.

Синтаксис

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

Параметры

pxlo

Указатель на структуру XLATEOBJ , из которой GDI получает запрошенные сведения.

[in] iPal

Идентифицирует данные палитры для записи. Этот параметр может иметь одно из следующих значений:

Значение Значение
XO_DESTBITFIELDS GDI извлекает формат битовых полей целевой палитры.
XO_DESTPALETTE GDI получает цвета RGB из целевой палитры.
XO_SRCBITFIELDS GDI извлекает формат битовых полей исходной палитры.
XO_SRCPALETTE GDI получает цвета RGB из исходной палитры.

cPal

Указывает количество записей в буфере, на которое указывает pPal. Это может быть меньше общего размера палитры.

pPal

Указатель на буфер, в котором GDI записывает запрошенные сведения о палитре. Если iPal XO_SRCPALETTE или XO_DESTPALETTE и соответствующий тип палитры PAL_INDEXED, каждая запись представляет собой 24-разрядное значение RGB.

Если iPal XO_SRCBITFIELDS или XO_DESTBITFIELDS, а соответствующий тип палитры — PAL_BITFIELDS, PAL_RGB или PAL_BGR, pPal указывает на три маски ULONG, представляющие красные, зеленые и синие маски цвета.

Возвращаемое значение

XLATEOBJ_cGetPalette возвращает количество записей, записанных, если pPal не имеет значения NULL. Возвращается значение нуля, если XLATEOBJ имеет значение NULL или его палитра недопустимая. XLATEOBJ_cGetPalette также возвращает ноль, если данные, на которые указывает pxlo , не соответствуют значению в iPal. Например, если данные, на которые указывает битовое поле, но для iPal задано значение XO_SRCPALETTE или XO_DESTPALETTE, XLATEOBJ_cGetPalette вернет ноль. Аналогичным образом, если данные, на которые указывает pxlo , являются палитрой, но iPal имеет значение XO_SRCBITFIELDS или XO_DESTBITFIELDS, XLATEOBJ_cGetPalette также возвращает ноль.

Комментарии

Драйвер должен иметь сведения о палитре для выполнения некоторых методов смешивания цветов.

Требования

   
Минимальная версия клиента Доступно в Windows 2000 и более поздних версиях операционных систем Windows.
Целевая платформа Универсальное
Верхняя часть winddi.h (включая Winddi.h)
Библиотека Win32k.lib
DLL Win32k.sys

См. также раздел

XLATEOBJ