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

  • Artigo

A função SetOverlayColorControls altera as configurações de controle de cor para a sobreposição determinada.

Sintaxe

PFND3DDDI_SETOVERLAYCOLORCONTROLS Pfnd3dddiSetoverlaycolorcontrols;

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

Parâmetros

hDevice

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

unnamedParam2

pData [in]

Um ponteiro para uma estrutura D3DDDIARG_SETOVERLAYCOLORCONTROLS que descreve parâmetros para alterar as configurações de controle de cores de uma sobreposição.

Retornar valor

SetOverlayColorControls retorna um dos seguintes valores:

Código de retorno Descrição
S_OK As configurações de controle de cor foram alteradas com êxito.
E_INVALIDARG Os parâmetros foram validados e determinados como incorretos.
E_OUTOFMEMORY SetOverlayColorControls 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 SetOverlayColorControls para alterar as configurações 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 SetOverlayColorControls para uma sobreposição que ainda não está visível. Nessa situação, quando o membro hOverlay da estrutura D3DDDIARG_SETOVERLAYCOLORCONTROLS apontada por pData é definido como NULL, o driver deve armazenar as configurações de controle de cores fornecidas e usá-las quando uma sobreposição que referencia o recurso especificado for criada.

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_SETOVERLAYCOLORCONTROLS

D3DDDI_DEVICEFUNCS