Compartilhar via

Função SetMonitorColorTemperature (highlevelmonitorconfigurationapi.h)

  • Artigo

Aviso

As funções de configuração do monitor físico funcionam usando o padrão MCCS (Conjunto de Comandos de Controle) do VESA Monitor em uma interface I2C. Muitos monitores não implementam totalmente esse padrão; portanto, o uso desses comandos pode resultar em um comportamento de monitor indefinido. Não recomendamos usar essas funções para monitores arbitrários sem validar fisicamente que elas funcionam conforme o esperado.

Define a temperatura de cor de um monitor.

Sintaxe

_BOOL SetMonitorColorTemperature(
  [in] HANDLE               hMonitor,
  [in] MC_COLOR_TEMPERATURE ctCurrentColorTemperature
);

Parâmetros

[in] hMonitor

Manipule para um monitor físico. Para obter o identificador do monitor, chame GetPhysicalMonitorsFromHMONITOR ou GetPhysicalMonitorsFromIDirect3DDevice9.

[in] ctCurrentColorTemperature

Temperatura da cor, especificada como membro da enumeração MC_COLOR_TEMPERATURE .

Valor retornado

Se a função for bem-sucedida, o valor retornado será TRUE. Se a função falhar, o valor retornado será FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

Se essa função tiver suporte, a função GetMonitorCapabilities retornará o sinalizador MC_CAPS_COLOR_TEMPERATURE. A função GetMonitorCapabilities também retorna o intervalo de temperaturas de cor compatíveis com o monitor. O parâmetro ctCurrentColorTemperature deve corresponder a um desses valores.

Alterar a temperatura da cor altera o ponto branco do monitor. Ele também pode alterar a unidade atual e obter configurações. Para obter as novas configurações de unidade e ganho, chame GetMonitorRedGreenOrBlueDrive e GetMonitorRedGreenOrBlueGain, respectivamente.

Essa função leva de 50 a 90 milissegundos para retornar.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho highlevelmonitorconfigurationapi.h
Biblioteca Dxva2.lib
DLL Dxva2.dll

Confira também

Monitorar funções de configuração