SetMonitorDisplayAreaPosition 函数 (highlevelmonitorconfigurationapi.h)

警告

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

设置监视器显示区域的水平或垂直位置。

增加水平位置会将显示区域向屏幕右侧移动;减小它会将显示区域向左移动。 增加垂直位置会将显示区域向屏幕顶部移动;减小它会将显示区域向底部移动。

语法

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

parameters

[in] hMonitor

物理监视器的句柄。 若要获取监视器句柄，请调用 GetPhysicalMonitorsFromHMONITOR 或 GetPhysicalMonitorsFromIDirect3DDevice9。

[in] ptPositionType

MC_POSITION_TYPE枚举的成员，指定是设置水平位置还是垂直位置。

[in] dwNewPosition

水平或垂直位置。 若要获取最小和最大位置，请调用 GetMonitorDisplayAreaPosition。

返回值

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

注解

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

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

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

要求

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

另请参阅

监视配置函数