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

Define a posição horizontal ou vertical da área de exibição de um monitor.

Aumentar a posição horizontal move a área de exibição em direção ao lado direito da tela; reduzindo-a move a área de exibição em direção à esquerda. Aumentar a posição vertical move a área de exibição em direção à parte superior da tela; diminuindo-a move a área de exibição em direção à parte inferior.

Sintaxe

_BOOL SetMonitorDisplayAreaPosition(
  [in] HANDLE           hMonitor,
  [in] MC_POSITION_TYPE ptPositionType,
  [in] DWORD            dwNewPosition
);

Parâmetros

[in] hMonitor

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

[in] ptPositionType

Um membro da enumeração MC_POSITION_TYPE , especificando se a posição horizontal ou vertical deve ser definida.

[in] dwNewPosition

Posição horizontal ou vertical. Para obter a posição mínima e máxima, chame GetMonitorDisplayAreaPosition.

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_DISPLAY_AREA_POSITION.

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

A posição horizontal e vertical 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