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


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

Функция SetOverlayColorControls изменяет параметры управления цветом для заданного наложения.

Синтаксис

PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;

HRESULT Pfnd3dddiSetoverlaycolorcontrols(
  HANDLE hDevice,
  const D3DDDIARG_SETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in]

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

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

SetOverlayColorControls возвращает одно из следующих значений:

Возвращаемый код Описание
S_OK Параметры управления цветом были успешно изменены.
E_INVALIDARG Параметры были проверены и определены как неверные.
E_OUTOFMEMORY SetOverlayColorControls не удалось выделить необходимую память для его завершения.

Замечания

Среда выполнения Microsoft Direct3D вызывает функцию SetOverlayColorControls для изменения яркости, контрастности, оттенка, насыщенности, гаммы и гамма-включения параметров, связанных с определенным наложением.

Среда выполнения также может вызывать SetOverlayColorControls для наложения, которое еще не видно. В этой ситуации, когда для элемента hOverlay структуры D3DDDIARG_SETOVERLAYCOLORCONTROLS, на которую указывает pData задано значение NULL, драйвер должен хранить предоставленные параметры управления цветом и использовать их при наложении, ссылающемся на указанный ресурс.

Требования

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

См. также

D3DDDIARG_SETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS