Fungsi EnumDisplayDevicesA (winuser.h)

Artikel
03/15/2023

Fungsi EnumDisplayDevices memungkinkan Anda mendapatkan informasi tentang perangkat tampilan di sesi saat ini.

Sintaks

BOOL EnumDisplayDevicesA(
  [in]  LPCSTR           lpDevice,
  [in]  DWORD            iDevNum,
  [out] PDISPLAY_DEVICEA lpDisplayDevice,
  [in]  DWORD            dwFlags
);

Parameter

[in] lpDevice

Penunjuk ke nama perangkat. Jika NULL, fungsi mengembalikan informasi untuk adaptor tampilan pada komputer, berdasarkan iDevNum.

Untuk informasi selengkapnya, lihat Keterangan.

[in] iDevNum

Nilai indeks yang menentukan perangkat tampilan yang diminati.

Sistem operasi mengidentifikasi setiap perangkat tampilan dalam sesi saat ini dengan nilai indeks. Nilai indeks adalah bilangan bulat berturut-turut, mulai dari 0. Jika sesi saat ini memiliki tiga perangkat tampilan, misalnya, mereka ditentukan oleh nilai indeks 0, 1, dan 2.

[out] lpDisplayDevice

Penunjuk ke struktur DISPLAY_DEVICE yang menerima informasi tentang perangkat tampilan yang ditentukan oleh iDevNum.

Sebelum memanggil EnumDisplayDevices, Anda harus menginisialisasi anggota cbDISPLAY_DEVICE ke ukuran, dalam byte, dari DISPLAY_DEVICE.

[in] dwFlags

Atur bendera ini ke EDD_GET_DEVICE_INTERFACE_NAME (0x00000001) untuk mengambil nama antarmuka perangkat untuk GUID_DEVINTERFACE_MONITOR, yang didaftarkan oleh sistem operasi per monitor. Nilai ditempatkan di anggota DeviceID dari struktur DISPLAY_DEVICE yang dikembalikan dalam lpDisplayDevice. Nama antarmuka perangkat yang dihasilkan dapat digunakan dengan fungsi SetupAPI dan berfungsi sebagai tautan antara perangkat monitor GDI dan perangkat monitor SetupAPI.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol. Fungsi gagal jika iDevNum lebih besar dari indeks perangkat terbesar.

Keterangan

Untuk mengkueri semua perangkat tampilan dalam sesi saat ini, panggil fungsi ini dalam perulangan, dimulai dengan iDevNum diatur ke 0, dan tahapan iDevNum hingga fungsi gagal. Untuk memilih semua perangkat tampilan di desktop, gunakan hanya perangkat tampilan yang memiliki bendera DISPLAY_DEVICE_ATTACHED_TO_DESKTOP dalam struktur DISPLAY_DEVICE .

Untuk mendapatkan informasi tentang adaptor tampilan, panggil EnumDisplayDevices dengan lpDevice diatur ke NULL. Misalnya, DISPLAY_DEVICE. DeviceString berisi nama adaptor.

Untuk mendapatkan informasi tentang monitor tampilan, pertama-tama panggil EnumDisplayDevices dengan lpDevice diatur ke NULL. Kemudian panggil EnumDisplayDevices dengan lpDevice diatur ke DISPLAY_DEVICE. DeviceName dari panggilan pertama ke EnumDisplayDevices dan dengan iDevNum diatur ke nol. Lalu DISPLAY_DEVICE. DeviceString adalah nama monitor.

Untuk mengkueri semua perangkat monitor yang terkait dengan adaptor, panggil EnumDisplayDevices dalam perulangan dengan lpDevice yang diatur ke nama adaptor, iDevNum diatur ke mulai dari 0, dan iDevNum diatur ke kenaikan hingga fungsi gagal. Perhatikan bahwa DISPLAY_DEVICE. DeviceName berubah dengan setiap panggilan untuk informasi pemantauan, jadi Anda harus menyimpan nama adaptor. Fungsi gagal ketika tidak ada lagi monitor untuk adaptor.

Catatan

Header winuser.h mendefinisikan EnumDisplayDevices sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (sertakan Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (diperkenalkan dalam Windows 10, versi 10.0.14393)