Поделиться через


функция обратного вызова PFND3DDDI_UPDATEPALETTE (d3dumddi.h)

Функция UpdatePalette обновляет палитру текстур.

Синтаксис

PFND3DDDI_UPDATEPALETTE Pfnd3dddiUpdatepalette;

HRESULT Pfnd3dddiUpdatepalette(
  [in] HANDLE hDevice,
       const D3DDDIARG_UPDATEPALETTE *unnamedParam2,
       const PALETTEENTRY *unnamedParam3
)
{...}

Параметры

[in] hDevice

Дескриптор устройства отображения (графический контекст).

unnamedParam2

pData [in]

Указатель на D3DDDIARG_UPDATEPALETTE структуру, описывающую параметры для операции обновления палитры.

unnamedParam3

pPaletteData [in]

Массив структур PALETTEENTRY для обновления. Дополнительные сведения о PALETTEENTRY см. в документации по пакету SDK для Microsoft Windows.

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

UpdatePalette возвращает S_OK или соответствующий результат ошибки, если палитра текстур не была успешно обновлена.

Замечания

Данные палитры в массиве, заданном pPaletteData, состоят из одного значения UINT для каждой записи палитры (структура PALETTEENTRY). Запись палитры находится в формате ARGB с 8 битами для каждого из четырех каналов.

Драйвер отображения в пользовательском режиме использует следующие элементы структуры D3DDDIARG_UPDATEPALETTE, на которые указывает pData для обновления палитры текстур:

  • Элемент PaletteHandle задает дескриптор палитры, связанной с поверхностью.
  • Элемент StartIndex указывает индекс записи в массиве на pPaletteData, где должно начинаться обновление.
  • Элемент NumEntries указывает количество записей в массиве в pPaletteData для обновления.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows Vista и более поздних версиях операционных систем Windows.
целевая платформа Настольный
заголовка d3dumddi.h (include D3dumddi.h)

См. также

D3DDDIARG_UPDATEPALETTE

D3DDDI_DEVICEFUNCS