Metode IDisplayInformationStaticsInterop::GetForMonitor (windows.graphics.display.interop.h)

Mengambil objek DisplayInformation untuk monitor yang ditentukan. GetForMonitor selalu mengalokasikan dan mengembalikan DisplayInformation baru.

Sintaks

HRESULT GetForMonitor(
  HMONITOR monitor,
  REFIID   riid,
  void     **displayInfo
);

Parameter

monitor

Jenis: [in]\ HMONITOR

Pegangan monitor.

riid

Jenis: [in]\ REFIID

GUID kelas DisplayInformation.

displayInfo

Jenis: [iid_is][retval][out] batal**

Penunjuk ke blok memori yang menerima penunjuk ke objek DisplayInformation yang dikembalikan.

Nilai kembali

Jenis: HRESULT

Jika fungsi berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahanHRESULT akan dikembalikan.

Keterangan

Pertimbangan:

• Gerakan jendela tidak dilacak, karena tidak ada jendela.
• Faktor skala apa pun yang dikembalikan oleh DisplayInformation adalah faktor skala saat ini untuk seluruh monitor. Virtualisasi DPI bertindak dengan cara yang sama seperti untuk GetScaleFactorForMonitor, yang merupakan API yang mendasari yang digunakan untuk membaca skala dalam kasus ini.
• Jika Anda ingin mendaftar untuk peristiwa, maka utas saat ini harus menjalankan Windows.System.DispatcherQueue , untuk menerima peristiwa. DispatcherQueue itu akan di-snap pada panggilan ke GetForMonitor. Jika tidak ada DispatcherQueue, maka pengecualian (pada tingkat antarmuka biner aplikasi, HRESULT) dikembalikan dalam metode pendaftaran penanganan aktivitas.
• Utas saat ini dapat berupa MTA atau STA.

Anda bertanggung jawab untuk: penembolokan DisplayInformation yang dibuat selama argumen monitor relevan; membatalkan pendaftaran penanganan aktivitas; dan menghilangkan referensi terakhir untuk menghancurkan instans DisplayInformation .

Contoh

Lihat contoh kode di IDisplayInformationStaticsInterop::GetForWindow.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 11 Build 22621
Header	windows.graphics.display.interop.h