Compartilhar via

Função GetMonitorRedGreenOrBlueGain (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 Monitor VESA) 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 eles funcionam conforme o esperado.

Recupera o valor de ganho vermelho, verde ou azul de um monitor.

Sintaxe

_BOOL GetMonitorRedGreenOrBlueGain(
  [in]  HANDLE       hMonitor,
  [in]  MC_GAIN_TYPE gtGainType,
  [out] LPDWORD      pdwMinimumGain,
  [out] LPDWORD      pdwCurrentGain,
  [out] LPDWORD      pdwMaximumGain
);

Parâmetros

[in] hMonitor

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

[in] gtGainType

Um membro da enumeração MC_GAIN_TYPE , especificando se o valor de ganho vermelho, verde ou azul deve ser recuperado.

[out] pdwMinimumGain

Recebe o valor mínimo de ganho vermelho, verde ou azul.

[out] pdwCurrentGain

Recebe o valor de ganho vermelho, verde ou azul atual.

[out] pdwMaximumGain

Recebe o valor máximo de ganho vermelho, verde ou azul.

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

As configurações de ganho geralmente são usadas para ajustar o ponto branco do monitor.

Se essa função tiver suporte, a função GetMonitorCapabilities retornará o sinalizador MC_CAPS_RED_GREEN_BLUE_GAIN.

Essa função leva cerca de 40 milissegundos para retornar.

As configurações de ganho são configurações de monitor contínuo. Para obter mais informações, consulte Usando as funções de configuração do High-Level Monitor.

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

GetMonitorRedGreenOrBlueDrive

Monitorar funções de configuração