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