SetMonitorDisplayAreaPosition 函式 (highlevelmonitorconfigurationapi.h)

警告

實體監視器組態函式的運作方式是使用 VESA 監視器控制命令集 (MCCS) I2C 介面的標準。 許多監視器未完全實作該標準;因此,使用這些命令可能會導致未定義的監視行為。 不建議將這些函式用於任意監視器,而不需實際驗證它們如預期般運作。

設定監視器顯示區域的水準或垂直位置。

增加水準位置會將顯示區域移至畫面右側;減少它會將顯示區域向左移動。 增加垂直位置會將顯示區域移至螢幕頂端;減少它會將顯示區域移至底部。

語法

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

參數

[in] hMonitor

實體監視器的控制碼。 若要取得監視控制碼,請呼叫 GetPhysicalMonitorsFromHMONITORGetPhysicalMonitorsFromIDirect3DDevice9

[in] ptPositionType

MC_POSITION_TYPE列舉的成員,指定是要設定水準位置還是垂直位置。

[in] dwNewPosition

水準或垂直位置。 若要取得最小和最大位置,請呼叫 GetMonitorDisplayAreaPosition

傳回值

如果函式成功,則傳回值為 TRUE。 如果函式失敗,則傳回值為 FALSE。 若要取得擴充的錯誤資訊,請呼叫 GetLastError

備註

如果支援此函式, GetMonitorCapabilities 函式會傳回MC_CAPS_DISPLAY_AREA_POSITION旗標。

此函式需要大約 50 毫秒的時間才能傳回。

水準和垂直位置是連續監視設定。 如需詳細資訊,請參閱 使用 High-Level 監視組態函式

需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 highlevelmonitorconfigurationapi.h
程式庫 Dxva2.lib
Dll Dxva2.dll

另請參閱

監視組態函式