Compartilhar via

Função GetMonitorCapabilities (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.

Recupera os recursos de configuração de um monitor. Chame essa função para descobrir quais funções de configuração de monitor de alto nível têm suporte do monitor.

Sintaxe

_BOOL GetMonitorCapabilities(
  [in]  HANDLE  hMonitor,
  [out] LPDWORD pdwMonitorCapabilities,
  [out] LPDWORD pdwSupportedColorTemperatures
);

Parâmetros

[in] hMonitor

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

[out] pdwMonitorCapabilities

Recebe um OR bit a bit de sinalizadores de funcionalidades. Consulte Observações.

[out] pdwSupportedColorTemperatures

Recebe um OR bit a bit de sinalizadores de temperatura de cor. Consulte Observações.

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.

A função falhará se o monitor não der suporte a DDC/CI.

Comentários

Os sinalizadores de funcionalidade retornados em pdwMonitorCapabilities especificam quais funções de configuração de monitor de alto nível têm suporte do monitor. Eles também especificam como determinadas funções se comportam. Os sinalizadores de recursos a seguir são definidos.

Valor Descrição
MC_CAPS_BRIGHTNESS O monitor dá suporte às funções GetMonitorBrightness e SetMonitorBrightness .
MC_CAPS_COLOR_TEMPERATURE O monitor dá suporte às funções GetMonitorColorTemperature e SetMonitorColorTemperature .
MC_CAPS_CONTRAST O monitor dá suporte às funções GetMonitorContrast e SetMonitorContrast .
MC_CAPS_DEGAUSS O monitor dá suporte à função DegaussMonitor .
MC_CAPS_DISPLAY_AREA_POSITION O monitor dá suporte às funções GetMonitorDisplayAreaPosition e SetMonitorDisplayAreaPosition .
MC_CAPS_DISPLAY_AREA_SIZE O monitor dá suporte às funções GetMonitorDisplayAreaSize e SetMonitorDisplayAreaSize .
MC_CAPS_MONITOR_TECHNOLOGY_TYPE O monitor dá suporte à função GetMonitorTechnologyType .
MC_CAPS_NONE O monitor não dá suporte a nenhuma configuração de monitor.
MC_CAPS_RED_GREEN_BLUE_DRIVE O monitor dá suporte às funções GetMonitorRedGreenOrBlueDrive e SetMonitorRedGreenOrBlueDrive .
MC_CAPS_RED_GREEN_BLUE_GAIN O monitor dá suporte às funções GetMonitorRedGreenOrBlueGain e SetMonitorRedGreenOrBlueGain .
MC_CAPS_RESTORE_FACTORY_COLOR_DEFAULTS O monitor dá suporte à função RestoreMonitorFactoryColorDefaults .
MC_CAPS_RESTORE_FACTORY_DEFAULTS O monitor dá suporte à função RestoreMonitorFactoryDefaults .
MC_RESTORE_FACTORY_DEFAULTS_ENABLES_MONITOR_SETTINGS Se esse sinalizador estiver presente, chamar a função RestoreMonitorFactoryDefaults habilitará todas as configurações de monitor usadas pelas funções de configuração de monitor de alto nível. Para obter mais informações, consulte a seção Comentários em RestoreMonitorFactoryDefaults.
 

Os sinalizadores de temperatura de cor retornados em pdwSupportedColorTemperatures especificam quais temperaturas de cor têm suporte do monitor. Os sinalizadores de temperatura de cor a seguir são definidos.

Valor Descrição
MC_SUPPORTED_COLOR_TEMPERATURE_NONE Não há suporte para temperaturas de cor.
MC_SUPPORTED_COLOR_TEMPERATURE_4000K O monitor dá suporte a 4.000 kelvins (K) temperatura de cor.
MC_SUPPORTED_COLOR_TEMPERATURE_5000K O monitor dá suporte à temperatura de cor de 5.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K O monitor dá suporte à temperatura de cor de 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K O monitor dá suporte à temperatura de cor de 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K O monitor dá suporte à temperatura de cor de 8.200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K O monitor dá suporte à temperatura de cor de 9.300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K O monitor dá suporte à temperatura de cor de 10.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K O monitor dá suporte à temperatura de cor de 11.500 K.

Requisitos

Requisito Valor
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