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 fornecida.
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 de D3DDDIARG_SETOVERLAYCOLORCONTROLS que descreve parâmetros para alterar as configurações de controle de cores de uma sobreposição.
Valor de retorno
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. |
Observações
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 hOverlay membro da estrutura D3DDDIARG_SETOVERLAYCOLORCONTROLS apontado por pData é definido como NULL, o driver deve armazenar as configurações de controle de cor fornecidas e usá-las quando uma sobreposição que referencia o recurso especificado for criada.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows. |
| da Plataforma de Destino | Área de trabalho |
| cabeçalho | d3dumddi.h (inclua D3dumddi.h) |