PFND3DDDI_SETOVERLAYCOLORCONTROLS função de retorno de chamada (d3dumddi.h)
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) |