Fungsi GetPhysicalMonitors

Penting

Fungsi ini digunakan oleh API konfigurasi monitor untuk mengakses fungsionalitas di driver tampilan. Aplikasi tidak boleh memanggil fungsi ini.

Mendapatkan monitor fisik yang terkait dengan perangkat tampilan.

Sintaks

NTSTATUS WINAPI GetPhysicalMonitors(
  _In_  UNICODE_STRING *pstrDeviceName,
  _In_  DWORD          dwPhysicalMonitorArraySize,
  _Out_ DWORD          *pdwNumPhysicalMonitorHandlesInArray,
  _Out_ HANDLE         *phPhysicalMonitorArray
);

Parameter

pstrDeviceName [in]

Penunjuk ke struktur UNICODE_STRING yang berisi nama perangkat tampilan, seperti yang dikembalikan oleh fungsi GetMonitorInfo .

dwPhysicalMonitorArraySize [in]

Jumlah elemen dalam array pdwNumPhysicalMonitorHandlesInArray . Untuk mendapatkan ukuran array yang diperlukan, panggil GetNumberOfPhysicalMonitors.

pdwNumPhysicalMonitorHandlesInArray [out]

Menerima jumlah item yang disalin fungsi ke array phPhysicalMonitorArray .

phPhysicalMonitorArray [out]

Array yang menerima handel ke monitor fisik. Setiap handel harus dilepaskan dengan memanggil DestroyPhysicalMonitor.

Menampilkan nilai

Jika metode berhasil, metode akan mengembalikan STATUS_SUCCESS. Jika tidak, kode kesalahan NTSTATUS akan dikembalikan.

Keterangan

Alih-alih menggunakan fungsi ini, aplikasi harus memanggil salah satu fungsi berikut:

• GetPhysicalMonitorsFromHMONITOR
• GetPhysicalMonitorsFromIDirect3DDevice9

Fungsi ini tidak memiliki pustaka impor terkait. Untuk memanggil fungsi ini, Anda harus menggunakan fungsi LoadLibrary dan GetProcAddress untuk menautkan secara dinamis ke Gdi32.dll.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
DLL	Gdi32.dll

Lihat juga

Memantau Fungsi Konfigurasi