функция обратного вызова PDD_VPORTCB_COLORCONTROL (ddrawint.h)
Функция обратного вызова DdVideoPortColorControl получает или задает элементы управления цветом объекта VPE.
Синтаксис
PDD_VPORTCB_COLORCONTROL PddVportcbColorcontrol;
DWORD PddVportcbColorcontrol(
PDD_VPORTCOLORDATA unnamedParam1
)
{...}
Параметры
unnamedParam1
Указывает на DD_VPORTCOLORDATA структуру, содержащую сведения, необходимые драйверу для получения текущих элементов управления цветом объекта VPE или задания новых значений.
Возвращаемое значение
DdVideoPortColorControl возвращает один из следующих кодов обратного вызова:
Комментарии
Драйверы DirectDraw, устанавливающие флаг DDVPCAPS_COLORCONTROL в структуре DDVIDEOPORTCAPS , должны реализовывать DdVideoPortColorControl.
В зависимости от значения элемента dwFlags структуры DD_VPORTCOLORDATA в lpColorControl драйвер должен выполнить следующие действия:
-
Если dwFlags DDRAWI_VPORTGETCOLOR, драйвер должен заполнить каждый элемент структуры DDCOLORCONTROL , которую он поддерживает, текущим параметром элемента управления цветом объекта VPE. Драйвер должен задать соответствующий бит в элементе dwFlags DDCOLORCONTROL для каждого элемента управления цветом, в котором он записывает данные.
DdVideoPortColorControl можно вызвать для определения возможностей управления цветом объекта VPE. Поэтому драйвер должен завершить вызов, если он не поддерживает запрошенную возможность управления цветом.
- Если параметр dwFlags DDRAWI_VPORTSETCOLOR, драйвер должен задать для параметров управления цветом объекта VPE значения, указанные в структуре DDCOLORCONTROL. Драйвер должен проверка член dwFlags DDCOLORCONTROL, чтобы определить, какие элементы структуры содержат допустимые данные.
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Персональный компьютер |
| Верхняя часть | ddrawint.h (включая Winddi.h) |