PFND3DDDI_GETOVERLAYCOLORCONTROLS função de retorno de chamada (d3dumddi.h)

  • Artigo

A função GetOverlayColorControls recupera as configurações de controle de cor para a sobreposição fornecida.

Sintaxe

PFND3DDDI_GETOVERLAYCOLORCONTROLS Pfnd3dddiGetoverlaycolorcontrols;

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

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in, out]

Um ponteiro para uma estrutura D3DDDIARG_GETOVERLAYCOLORCONTROLS que descreve parâmetros para recuperar as configurações de controle de cor de uma sobreposição.

Retornar valor

GetOverlayColorControls retorna um dos seguintes valores:

Código de retorno Descrição
S_OK As configurações de controle de cor foram recuperadas com êxito.
E_INVALIDARG Os parâmetros foram validados e determinados como incorretos.
E_OUTOFMEMORY GetOverlayColorControls não pôde alocar a memória necessária para que ela fosse concluída.

Comentários

O runtime do Microsoft Direct3D chama a função GetOverlayColorControls para retornar as configurações atuais de brilho, contraste, matiz, saturação, nitidez, gama e habilitação de cores associadas a uma sobreposição específica.

O runtime também pode chamar GetOverlayColorControls para uma sobreposição que ainda não está visível. Nessa situação, quando o membro hOverlay da estrutura de D3DDDIARG_GETOVERLAYCOLORCONTROLS apontada por pData é definido como NULL, o driver deve retornar as configurações padrão de controle de cores do hardware de sobreposição.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho d3dumddi.h (inclua D3dumddi.h)

Confira também

D3DDDIARG_GETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS