Compartir a través de

Función SetMonitorDisplayAreaPosition (highlevelmonitorconfigurationapi.h)

  • Artículo

Advertencia

Las funciones de configuración del monitor físico funcionan con el estándar veSA Monitor Control Command Set (MCCS) a través de una interfaz I2C. Muchos monitores no implementan completamente ese estándar; por lo tanto, el uso de estos comandos podría dar lugar a un comportamiento de supervisión no definido. No se recomienda usar estas funciones para monitores arbitrarios sin validar físicamente que funcionan según lo previsto.

Establece la posición horizontal o vertical del área de visualización de un monitor.

El aumento de la posición horizontal mueve el área de visualización hacia el lado derecho de la pantalla; disminuyendo mueve el área de presentación hacia la izquierda. El aumento de la posición vertical mueve el área de visualización hacia la parte superior de la pantalla; disminuyendo mueve el área de presentación hacia la parte inferior.

Sintaxis

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

Parámetros

[in] hMonitor

Identificador de un monitor físico. Para obtener el identificador del monitor, llame a GetPhysicalMonitorsFromHMONITOR o GetPhysicalMonitorsFromIDirect3DDevice9.

[in] ptPositionType

Miembro de la enumeración MC_POSITION_TYPE , especificando si se va a establecer la posición horizontal o la posición vertical.

[in] dwNewPosition

Posición horizontal o vertical. Para obtener la posición mínima y máxima, llame a GetMonitorDisplayAreaPosition.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE. Si se produce un error en la función, el valor devuelto es FALSE. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Si se admite esta función, la función GetMonitorCapabilities devuelve la marca MC_CAPS_DISPLAY_AREA_POSITION.

Esta función tarda aproximadamente 50 milisegundos en devolverse.

La posición horizontal y vertical son configuraciones de supervisión continuas. Para obtener más información, vea Uso de las funciones de configuración de High-Level Monitor.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado highlevelmonitorconfigurationapi.h
Library Dxva2.lib
Archivo DLL Dxva2.dll

Consulte también

Supervisar funciones de configuración