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


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

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

Синтаксис

PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;

HRESULT Pfnd3dddiGetoverlaycolorcontrols(
  HANDLE hDevice,
  D3DDDIARG_GETOVERLAYCOLORCONTROLS *unnamedParam2
)
{...}

Параметры

hDevice

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

unnamedParam2

pData [in, out]

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

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

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

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

Замечания

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

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

Требования

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

См. также

D3DDDIARG_GETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS