RegisterScaleChangeEvent 函式 (shellscalingapi.h)

註冊調整可能變更時所觸發的事件。此函式會取代 RegisterScaleChangeNotifications。

語法

HRESULT RegisterScaleChangeEvent(
  [in]  HANDLE    hEvent,
  [out] DWORD_PTR *pdwCookie
);

[in] hEvent

要註冊調整變更通知的事件句柄。

[out] pdwCookie

當此函式成功傳回時，這個值會接收 Cookie 的指標位址，以便稍後透過 UnregisterScaleChangeEvent 取消註冊調整變更通知。

如果此函式成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

每當會影響縮放比例變更的內容時，就會引發事件，但只是因為縮放比例可能會受到影響，並不表示它已經發生。呼叫端可以快取縮放比例，以確認監視器的縮放比例實際上已變更。事件句柄將會重複，因此呼叫端可以隨時關閉其句柄。