GetMonitorDisplayAreaPosition 函数 (highlevelmonitorconfigurationapi.h)

警告

物理监视器配置功能通过 I2C 接口使用 VESA 监视器控制命令集 (MCCS) 标准。 许多监视器未完全实现该标准;因此,使用这些命令可能会导致未定义的监视器行为。 在未对任意监视器进行物理验证的情况下,不建议将这些函数用于任意监视器,因为它们是否按预期工作。

检索监视器的最小、最大和当前水平或垂直位置。

语法

_BOOL GetMonitorDisplayAreaPosition(
  [in]  HANDLE           hMonitor,
  [in]  MC_POSITION_TYPE ptPositionType,
  [out] LPDWORD          pdwMinimumPosition,
  [out] LPDWORD          pdwCurrentPosition,
  [out] LPDWORD          pdwMaximumPosition
);

parameters

[in] hMonitor

物理监视器的句柄。 若要获取监视器句柄,请调用 GetPhysicalMonitorsFromHMONITORGetPhysicalMonitorsFromIDirect3DDevice9

[in] ptPositionType

MC_POSITION_TYPE枚举的成员,指定是检索水平位置还是垂直位置。

[out] pdwMinimumPosition

接收最小水平或垂直位置。

[out] pdwCurrentPosition

接收当前水平或垂直位置。

[out] pdwMaximumPosition

接收最大水平或垂直位置。

返回值

如果函数成功,则返回值为 TRUE。 如果函数失败,则返回值为 FALSE。 要获得更多的错误信息,请调用 GetLastError。

注解

如果支持此函数, GetMonitorCapabilities 函数将返回 MC_CAPS_DISPLAY_AREA_POSITION 标志。

此函数大约需要 40 毫秒才能返回。

水平和垂直位置是连续监视器设置。 有关详细信息,请参阅 使用 High-Level Monitor 配置函数

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 highlevelmonitorconfigurationapi.h
Library Dxva2.lib
DLL Dxva2.dll

另请参阅

监视配置函数