Fungsi EnumDisplayDevicesA (winuser.h)

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

Sintaksis

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 menarik.

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 memanggilEnumDisplayDevices , Anda harus menginisialisasi cb anggota DISPLAY_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 dalam 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.

Mengembalikan nilai

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.

Komentar

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 keNULL . Kemudian panggil EnumDisplayDevices dengan lpDevice diatur ke DISPLAY_DEVICE. DeviceName dari panggilan pertama ke EnumDisplayDevices dan dengan iDevNum diatur ke nol. Kemudian DISPLAY_DEVICE.DeviceString adalah nama monitor.

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

Nota

Header winuser.h mendefinisikan EnumDisplayDevices sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat	Nilai
klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
set API	ext-ms-win-ntuser-sysparams-ext-l1-1-1 (diperkenalkan di Windows 10, versi 10.0.14393)

Lihat juga

ChangeDisplaySettings

ChangeDisplaySettingsEx

CreateDC

DEVMODE

DISPLAY_DEVICE

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

EnumDisplaySettings