SetProcessDpiAwareness 函式 (殼層calingapi.h)

  • 發行項

設定進程預設 DPI 感知層級。 這相當於使用對應的DPI_AWARENESS_CONTEXT值呼叫 SetProcessDpiAwarenessContext。

注意

建議您透過應用程式指令清單來設定處理程式預設 DPI 感知，而不是 API 呼叫。 如需詳細資訊 ，請參閱為進程設定預設 DPI 感知 。 透過 API 呼叫設定進程預設 DPI 感知可能會導致非預期的應用程式行為。

語法

HRESULT SetProcessDpiAwareness(
  [in] PROCESS_DPI_AWARENESS value
);

參數

[in] value

要設定的 DPI 感知值。 可能的值為來自 PROCESS_DPI_AWARENESS 列舉。

傳回值

此函式會傳回下列其中一個值。

傳回碼 描述
S_OK
 已成功設定應用程式的 DPI 感知。
E_INVALIDARG
 傳入的值無效。
E_ACCESSDENIED
 先前或透過應用程式 (.exe) 指令清單呼叫此 API，已設定 DPI 感知。

備註

舊版 Windows 只有整個應用程式的一個 DPI 感知值。 對於這些應用程式，建議在指令清單中設定 DPI 感知值，如 PROCESS_DPI_AWARENESS中所述。 在該建議下，您不應該使用 SetProcessDpiAwareness 來更新 DPI 感知。 事實上，未來對此 API 的呼叫會在設定 DPI 感知一次之後失敗。 現在 DPI 感知已系結至線程而非應用程式，您可以使用這個方法來更新 DPI 感知。 不過，請考慮改用 SetThreadDpiAwarenessContext 。

重要  

對於較舊的應用程式，強烈建議不要使用 SetProcessDpiAwareness 來設定應用程式的 DPI 感知。 相反地，您應該在應用程式指令清單中宣告應用程式的 DPI 感知。 如需 DPI 感知值的詳細資訊，以及如何在指令清單中設定它們，請參閱 PROCESS_DPI_AWARENESS 。

 
您必須先呼叫此 API，才能呼叫相依於 dpi 感知的任何 API。 這是建議使用應用程式指令清單而非 SetProcessDpiAwareness API 的一部分。 為應用程式設定 API 感知之後，任何未來對此 API 的呼叫都會失敗。 不論您是在指令清單中設定 DPI 感知，還是使用此 API，都是如此。

如果未設定 DPI 感知等級，則預設值為 PROCESS_DPI_UNAWARE。

規格需求

需求 值
最低支援的用戶端 Windows 8.1 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 shellscalingapi.h
程式庫 Shcore.lib
Dll Shcore.dll

另請參閱

PROCESS_DPI_AWARENESS

SetThreadDpiAwarenessContext

設定進程的預設 DPI 感知