Compartilhar via

Função GetMonitorRedGreenOrBlueDrive (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 o valor da unidade vermelha, verde ou azul de um monitor.

Sintaxe

_BOOL GetMonitorRedGreenOrBlueDrive(
  [in]  HANDLE        hMonitor,
  [in]  MC_DRIVE_TYPE dtDriveType,
  [out] LPDWORD       pdwMinimumDrive,
  [out] LPDWORD       pdwCurrentDrive,
  [out] LPDWORD       pdwMaximumDrive
);

Parâmetros

[in] hMonitor

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

[in] dtDriveType

Um membro da enumeração MC_DRIVE_TYPE , especificando se deseja recuperar o valor da unidade vermelha, verde ou azul.

[out] pdwMinimumDrive

Recebe o valor mínimo da unidade vermelha, verde ou azul.

[out] pdwCurrentDrive

Recebe o valor atual da unidade vermelha, verde ou azul.

[out] pdwMaximumDrive

Recebe o valor máximo da unidade vermelha, 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 unidade geralmente são usadas para ajustar o ponto branco do monitor. Unidade e nível preto são nomes diferentes para a mesma configuração de monitor. Se essa função tiver suporte, a função GetMonitorCapabilities retornará o sinalizador MC_CAPS_RED_GREEN_BLUE_DRIVE.

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

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

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