Fungsi GetScaleFactorForMonitor (shellscalingapi.h)

Mendapatkan faktor skala monitor tertentu. Fungsi ini menggantikan GetScaleFactorForDevice.

Sintaks

HRESULT GetScaleFactorForMonitor(
  [in]  HMONITOR            hMon,
  [out] DEVICE_SCALE_FACTOR *pScale
);

Parameter

[in] hMon

Pegangan monitor.

[out] pScale

Ketika fungsi ini berhasil dikembalikan, nilai ini menunjuk ke salah satu nilai DEVICE_SCALE_FACTOR yang menentukan faktor skala monitor yang ditentukan.

Jika panggilan fungsi gagal, nilai ini menunjuk ke faktor skala yang valid sehingga aplikasi dapat memilih untuk melanjutkan dengan sumber daya berukuran salah.

Menampilkan nilai

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

Keterangan

Kode Anda perlu menangani pesan WM_WINDOWPOSCHANGED selain peristiwa perubahan skala yang terdaftar melalui RegisterScaleChangeEvent, karena jendela aplikasi dapat dipindahkan di antara monitor. Sebagai respons terhadap pesan WM_WINDOWPOSCHANGED , panggil MonitorFromWindow, diikuti oleh GetScaleFactorForMonitor untuk mendapatkan faktor skala monitor tempat jendela aplikasi berada. Kode Anda kemudian dapat bereaksi terhadap perubahan titik per inci (dpi) dengan memuat ulang aset dan mengubah tata letak.

Persyaratan

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

RegisterScaleChangeEvent

Batalkan pendaftaranScaleChangeEvent