Compartilhar via


Função NtGdiDdColorControl

[Essa função está sujeita a alterações com cada revisão do sistema operacional. Em vez disso, use o Microsoft DirectDraw e o Microsoft Direct3DAPIs; essas APIs isolam os aplicativos dessas alterações do sistema operacional e ocultam muitas outras dificuldades envolvidas na interação diretamente com drivers de exibição.]

Controla os controles de luminância e brilho de uma superfície de sobreposição.

Sintaxe

DWORD APIENTRY NtGdiDdColorControl(
  _In_    HANDLE               hSurface,
  _Inout_ PDD_COLORCONTROLDATA puColorControlData
);

Parâmetros

hSurface [in]

Manipule para a estrutura DD_SURFACE_LOCAL que representa a superfície de sobreposição.

puColorControlData [in, out]

Ponteiro para uma estrutura de DD_COLORCONTROLDATA que contém as informações de controle de cores para uma superfície de sobreposição especificada.

Valor retornado

NtGdiDdColorControl retorna um dos seguintes códigos de retorno de chamada.

Código de retorno Descrição
DDHAL_DRIVER_HANDLED
O driver executou a operação e retornou um código de retorno válido para essa operação. Se esse código for DD_OK, DirectDraw ou Direct3D prosseguirá com a função . Caso contrário, DirectDraw ou Direct3D retornará o código de erro fornecido pelo driver e anulará a função.
DDHAL_DRIVER_NOTHANDLED
O driver não tem comentários sobre a operação solicitada. Se o driver for necessário para ter implementado um retorno de chamada específico, DirectDraw ou Direct3D relatará uma condição de erro. Caso contrário, DirectDraw ou Direct3D manipula a operação como se o retorno de chamada do driver não tivesse sido definido executando a implementação independente do dispositivo DirectDraw ou Direct3D.

 

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Ntgdi.h

Confira também

Suporte ao cliente de baixo nível de gráficos