Fungsi EnumDisplaySettingsA (winuser.h)

Fungsi EnumDisplaySettings mengambil informasi tentang salah satu mode grafis untuk perangkat tampilan. Untuk mengambil informasi untuk semua mode grafis perangkat tampilan, lakukan serangkaian panggilan ke fungsi ini.

Catatan Aplikasi yang Anda desain untuk menargetkan Windows 8 dan yang lebih baru tidak dapat lagi mengkueri atau mengatur mode tampilan yang kurang dari 32 bit per piksel (bpp); operasi ini akan gagal. Aplikasi ini memiliki manifes kompatibilitas yang menargetkan Windows 8. Windows 8 masih mendukung mode warna 8-bit dan 16-bit untuk aplikasi desktop yang dibangun tanpa manifes Windows 8; Windows 8 menimulasi mode ini tetapi masih berjalan dalam mode warna 32-bit.

 

Sintaksis

BOOL EnumDisplaySettingsA(
  [in]  LPCSTR   lpszDeviceName,
  [in]  DWORD    iModeNum,
  [out] DEVMODEA *lpDevMode
);

Parameter

[in] lpszDeviceName

Penunjuk ke string yang dihentikan null yang menentukan perangkat tampilan tentang mode grafis yang fungsinya akan mendapatkan informasi.

Parameter ini NULL atau DISPLAY_DEVICE.DeviceName dikembalikan dariEnumDisplayDevices . Nilai NULL menentukan perangkat tampilan saat ini pada komputer tempat utas panggilan berjalan.

[in] iModeNum

Jenis informasi yang akan diambil. Nilai ini bisa berupa indeks mode grafis atau salah satu nilai berikut.

Nilai	Arti
ENUM_CURRENT_SETTINGS	Ambil pengaturan saat ini untuk perangkat tampilan.
ENUM_REGISTRY_SETTINGS	Ambil pengaturan untuk perangkat tampilan yang saat ini disimpan di registri.

 

Indeks mode grafis dimulai dari nol. Untuk mendapatkan informasi untuk semua mode grafis perangkat tampilan, lakukan serangkaian panggilan ke EnumDisplaySettings, sebagai berikut: Atur iModeNum ke nol untuk panggilan pertama, dan kenaikan iModeNum satu untuk setiap panggilan berikutnya. Lanjutkan memanggil fungsi hingga nilai yang dikembalikan adalah nol.

Saat Anda memanggil EnumDisplaySettings dengan iModeNum diatur ke nol, sistem operasi menginisialisasi dan menyimpan informasi tentang perangkat tampilan. Saat Anda memanggil EnumDisplaySettings dengan iModeNum diatur ke nilai bukan nol, fungsi mengembalikan informasi yang di-cache terakhir kali fungsi dipanggil dengan iModeNum diatur ke nol.

[out] lpDevMode

Penunjuk ke struktur DEVMODE tempat fungsi menyimpan informasi tentang mode grafik yang ditentukan. Sebelum memanggil EnumDisplaySettings, atur anggota dmSize ke , dan atur anggota dmDriverExtra untuk menunjukkan ukuran, dalam byte, dari ruang tambahan yang tersedia untuk menerima data driver privat.

Fungsi EnumDisplaySettings menetapkan nilai untuk lima anggota DEVMODE berikut:

• dmBitsPerPel
• dmPelsWidth
• dmPelsHeight
• dmDisplayFlags
• dmDisplayFrequency

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Komentar

Fungsi gagal jika iModeNum lebih besar dari indeks mode grafis terakhir perangkat tampilan. Seperti yang disebutkan dalam deskripsi parameter iModeNum, Anda dapat menggunakan perilaku ini untuk menghitung semua mode grafis perangkat tampilan.

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Output yang diberikan selalu dalam hal piksel fisik, dan tidak terkait dengan konteks panggilan.

Nota

Header winuser.h mendefinisikan EnumDisplaySettings sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur 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-0 (diperkenalkan di Windows 8)

Lihat juga

ChangeDisplaySettings

ChangeDisplaySettingsEx

CreateDC

CreateDesktop

DEVMODE

DISPLAY_DEVICE

Fungsi Konteks Perangkat

Gambaran Umum Konteks Perangkat

EnumDisplayDevices