Метод IDirectDrawPalette::GetCaps (ddraw.h)
Извлекает возможности объекта палитры.
Синтаксис
HRESULT GetCaps(
[out] LPDWORD unnamedParam1
);
Параметры
[out] unnamedParam1
Указатель на переменную, которая получает значение из члена dwPalCaps структуры DDCAPS , определяющей возможности палитры. Это значение состоит из одного или нескольких следующих флагов.
DDPCAPS_1BIT
Индекс равен 1 биту. В таблице color есть две записи.
DDPCAPS_2BIT
Индекс равен 2 битам. В таблице color есть четыре записи.
DDPCAPS_4BIT
Индекс равен 4 битам. В таблице color есть 16 записей.
DDPCAPS_8BIT
Индекс равен 8 битам. В таблице color есть 256 записей.
DDPCAPS_8BITENTRIES
Индекс ссылается на 8-разрядный цветовый индекс. Этот флаг действителен только при использовании с флагом DDPCAPS_1BIT, DDPCAPS_2BIT или DDPCAPS_4BIT и если целевая поверхность составляет 8 bpp. Каждая запись цвета имеет длину 1 байт и является индексом палитры 8 кпп целевой поверхности.
DDPCAPS_ALPHA
Элемент peFlags связанной структуры PALETTEENTRY должен интерпретироваться как одно 8-битовое альфа-значение (в дополнение к элементам peRed, peGreen и peBlue ). Палитра, созданная с этим флагом, может быть присоединена только к текстуре: поверхности, созданной с флагом возможности DDSCAPS_TEXTURE.
DDPCAPS_ALLOW256
Эта палитра может содержать все 256 записей.
DDPCAPS_PRIMARYSURFACE
Эта палитра прикрепляется к основной поверхности. Изменение таблицы цветов этой палитры немедленно влияет на отображение, если DDPSETPAL_VSYNC не указан и не поддерживается.
DDPCAPS_PRIMARYSURFACELEFT
Эта палитра прикреплена к основной поверхности левого глаза. Изменение таблицы цветов этой палитры немедленно влияет на отображение левого глаза, если не указано и не поддерживается DDPSETPAL_VSYNC.
DDPCAPS_VSYNC
Эта палитра может иметь изменения, синхронизированные с частотой обновления монитора.
Возвращаемое значение
Если метод выполнен успешно, возвращаемое значение будет DD_OK.
В случае сбоя метод может вернуть одно из следующих значений ошибки:
- DDERR_INVALIDOBJECT
- DDERR_INVALIDPARAMS
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Windows |
| Header | ddraw.h |
| Библиотека | Ddraw.lib |
| DLL | Ddraw.dll |