RegisterScaleChangeEvent 関数 (shellscalingapi.h)

  • [アーティクル]

スケールが変更された可能性がある場合にトリガーされるイベントに登録します。 この関数は RegisterScaleChangeNotifications を置き換えます。

構文

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

パラメーター

[in] hEvent

スケール変更通知に登録するイベントのハンドル。

[out] pdwCookie

この関数が正常に返されると、この値は、後で UnregisterScaleChangeEvent を使用してスケール変更通知の登録を解除するために使用できる Cookie へのポインターのアドレスを受け取ります。

戻り値

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

注釈

イベントは、スケールの変更に影響を与える可能性がある場合に発生しますが、スケールが影響を受ける可能性があるからといって、そのイベントが発生したというわけではありません。 呼び出し元は、スケール ファクターをキャッシュして、モニターのスケールが実際に変更されたことを確認できます。 イベント ハンドルは重複するため、呼び出し元はいつでもハンドルを閉じることができます。

要件

要件 値
サポートされている最小のクライアント Windows 8.1 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2012 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shellscalingapi.h
Library Shcore.lib
[DLL] Shcore.dll

こちらもご覧ください

GetScaleFactorForMonitor

UnregisterScaleChangeEvent