Função GetMonitorCapabilities (highlevelmonitorconfigurationapi.h)

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 I²C. 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 Comentários.

[out] pdwSupportedColorTemperatures

Recebe um OR bit a bit de sinalizadores de temperatura de cor. Consulte Comentários.

Valor de retorno

Se a função obtiver êxito, 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.

Observações

Os sinalizadores de recursos 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 do 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 são compatíveis com o 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 da cor de 5.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_6500K	O monitor dá suporte à temperatura da cor de 6.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_7500K	O monitor dá suporte à temperatura da cor de 7.500 K.
MC_SUPPORTED_COLOR_TEMPERATURE_8200K	O monitor dá suporte à temperatura da cor de 8.200 K.
MC_SUPPORTED_COLOR_TEMPERATURE_9300K	O monitor dá suporte à temperatura da cor de 9.300 K.
MC_SUPPORTED_COLOR_TEMPERATURE_10000K	O monitor dá suporte à temperatura da cor de 10.000 K.
MC_SUPPORTED_COLOR_TEMPERATURE_11500K	O monitor dá suporte à temperatura da cor de 11.500 K.

Requisitos

Requisito	Valor
Cliente mínimo suportado	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo compatível	Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	highlevelmonitorconfigurationapi.h
Biblioteca	Dxva2.lib
de DLL	Dxva2.dll

Consulte também

Monitorar Funções de Configuração