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 [dentro, fora]
Um ponteiro para uma estrutura de D3DDDIARG_GETOVERLAYCOLORCONTROLS que descreve parâmetros para recuperar as configurações de controle de cores de uma sobreposição.
Valor de retorno
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. |
Observações
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 hOverlay membro da estrutura de D3DDDIARG_GETOVERLAYCOLORCONTROLS apontado por pData está definido como NULL, o driver deve retornar as configurações de controle de cor padrão do hardware de sobreposição.
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) |