Fungsi RegisterScaleChangeEvent (shellscalingapi.h)

  • Artikel

Mendaftar untuk peristiwa yang dipicu ketika skala mungkin telah berubah. Fungsi ini menggantikan RegisterScaleChangeNotifications.

Sintaks

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

Parameter

[in] hEvent

Tangani peristiwa untuk mendaftar pemberitahuan perubahan skala.

[out] pdwCookie

Ketika fungsi ini berhasil dikembalikan, nilai ini menerima alamat penunjuk ke cookie yang dapat digunakan nanti untuk membatalkan pendaftaran pemberitahuan perubahan skala melalui UnregisterScaleChangeEvent.

Nilai kembali

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

Keterangan

Peristiwa ini dimunculkan setiap kali sesuatu yang dapat memengaruhi perubahan skala, tetapi hanya karena skala dapat terpengaruh tidak berarti bahwa itu telah terjadi. Penelepon dapat menyimpan faktor skala untuk memverifikasi bahwa skala monitor benar-benar telah berubah. Penanganan aktivitas akan diduplikasi, sehingga penelepon dapat menutup handel mereka kapan saja.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8.1 [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2012 R2 [hanya aplikasi desktop]
Target Platform Windows
Header shellscalingapi.h
Pustaka Shcore.lib
DLL Shcore.dll

Lihat juga

GetScaleFactorForMonitor

Batalkan pendaftaranScaleChangeEvent