Fungsi RegisterScaleChangeNotifications (shellscalingapi.h)

Artikel
03/04/2024

Mendaftarkan jendela untuk menerima panggilan balik saat menskalakan informasi berubah.

Catatan Fungsi ini tidak didukung pada Windows 8.1. Gunakan RegisterScaleChangeEvent sebagai gantinya.

Sintaks

HRESULT RegisterScaleChangeNotifications(
  [in]  DISPLAY_DEVICE_TYPE displayDevice,
  [in]  HWND                hwndNotify,
  [in]  UINT                uMsgNotify,
  [out] DWORD               *pdwCookie
);

Parameter

[in] displayDevice

Jenis: DISPLAY_DEVICE_TYPE

Nilai enum yang menunjukkan perangkat tampilan mana yang akan menerima pemberitahuan.

[in] hwndNotify

Jenis: HWND

Handel jendela yang akan menerima pemberitahuan.

[in] uMsgNotify

Jenis: UINT

Pesan yang ditentukan aplikasi yang diteruskan ke jendela yang ditentukan oleh hwndNotify saat menskalakan informasi berubah. Biasanya, ini harus diatur ke WM_APP+x, di mana x adalah nilai bilangan bulat.

[out] pdwCookie

Jenis: DWORD*

Penunjuk ke nilai yang, ketika fungsi ini berhasil dikembalikan, menerima token pendaftaran. Token ini digunakan untuk mencabut pemberitahuan dengan memanggil RevokeScaleChangeNotifications.

Nilai kembali

Jenis: STDAPI

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Pesan yang ditentukan oleh uMsgNotify ini diposting ke jendela terdaftar melalui PostMessage. WParam pesan dapat berisi kombinasi SCALE_CHANGE_FLAGS yang menjelaskan perubahan yang terjadi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8 [khusus aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	shellscalingapi.h
DLL	Shcore.dll

Lihat juga

GetScaleFactorForMonitor

RegisterScaleChangeEvent

Batalkan pendaftaranScaleChangeEvent

Bagikan melalui