Fungsi GetDeviceCaps (wingdi.h)
Fungsi GetDeviceCaps mengambil informasi khusus perangkat untuk perangkat yang ditentukan.
Sintaks
int GetDeviceCaps(
[in] HDC hdc,
[in] int index
);
Parameter
[in] hdc
Handel ke DC.
[in] index
Item yang akan dikembalikan. Parameter ini bisa menjadi salah satu nilai berikut.
| Indeks | Makna | ||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Versi driver perangkat. | ||||||||||||||||||||||||||||||||||
|
Teknologi perangkat. Ini bisa menjadi salah satu nilai berikut.
Jika parameter hdc adalah handel ke DC metafile yang ditingkatkan, teknologi perangkat adalah perangkat yang direferensikan sebagaimana ditentukan ke fungsi CreateEnhMetaFile . Untuk menentukan apakah itu DC metafile yang disempurnakan, gunakan fungsi GetObjectType . |
||||||||||||||||||||||||||||||||||
|
Lebar, dalam milimeter, dari layar fisik. | ||||||||||||||||||||||||||||||||||
|
Tinggi, dalam milimeter, dari layar fisik. | ||||||||||||||||||||||||||||||||||
|
Lebar, dalam piksel, layar; atau untuk printer, lebar, dalam piksel, dari area halaman yang dapat dicetak. | ||||||||||||||||||||||||||||||||||
|
Tinggi, dalam garis raster, dari layar; atau untuk printer, tinggi, piksel, dari area halaman yang dapat dicetak. | ||||||||||||||||||||||||||||||||||
|
Jumlah piksel per inci logis di sepanjang lebar layar. Dalam sistem dengan beberapa monitor tampilan, nilai ini sama untuk semua monitor. | ||||||||||||||||||||||||||||||||||
|
Jumlah piksel per inci logis di sepanjang tinggi layar. Dalam sistem dengan beberapa monitor tampilan, nilai ini sama untuk semua monitor. | ||||||||||||||||||||||||||||||||||
|
Jumlah bit warna yang bersebelahan untuk setiap piksel. | ||||||||||||||||||||||||||||||||||
|
Jumlah bidang warna. | ||||||||||||||||||||||||||||||||||
|
Jumlah kuas khusus perangkat. | ||||||||||||||||||||||||||||||||||
|
Jumlah pena khusus perangkat. | ||||||||||||||||||||||||||||||||||
|
Jumlah font khusus perangkat. | ||||||||||||||||||||||||||||||||||
|
Jumlah entri dalam tabel warna perangkat, jika perangkat memiliki kedalaman warna tidak lebih dari 8 bit per piksel. Untuk perangkat dengan kedalaman warna yang lebih besar, -1 dikembalikan. | ||||||||||||||||||||||||||||||||||
|
Lebar relatif piksel perangkat yang digunakan untuk menggambar garis. | ||||||||||||||||||||||||||||||||||
|
Tinggi relatif piksel perangkat yang digunakan untuk menggambar garis. | ||||||||||||||||||||||||||||||||||
|
Lebar diagonal piksel perangkat yang digunakan untuk menggambar garis. | ||||||||||||||||||||||||||||||||||
|
Dicadangkan. | ||||||||||||||||||||||||||||||||||
|
Bendera yang menunjukkan kemampuan kliping perangkat. Jika perangkat dapat mengklip ke persegi panjang, itu adalah 1. Jika tidak, itu adalah 0. | ||||||||||||||||||||||||||||||||||
|
Jumlah entri dalam palet sistem. Indeks ini hanya valid jika driver perangkat mengatur bit RC_PALETTE dalam indeks RASTERCAPS dan hanya tersedia jika driver kompatibel dengan Windows 16-bit. | ||||||||||||||||||||||||||||||||||
|
Jumlah entri yang dipesan dalam palet sistem. Indeks ini hanya valid jika driver perangkat mengatur bit RC_PALETTE dalam indeks RASTERCAPS dan hanya tersedia jika driver kompatibel dengan Windows 16-bit. | ||||||||||||||||||||||||||||||||||
|
Resolusi warna aktual perangkat, dalam bit per piksel. Indeks ini hanya valid jika driver perangkat mengatur bit RC_PALETTE dalam indeks RASTERCAPS dan hanya tersedia jika driver kompatibel dengan Windows 16-bit. | ||||||||||||||||||||||||||||||||||
|
Untuk perangkat pencetakan: lebar halaman fisik, di unit perangkat. Misalnya, printer yang diatur untuk mencetak pada 600 dpi pada kertas 8,5-x11-inci memiliki nilai lebar fisik 5100 unit perangkat. Perhatikan bahwa halaman fisik hampir selalu lebih besar dari area halaman yang dapat dicetak, dan tidak pernah lebih kecil. | ||||||||||||||||||||||||||||||||||
|
Untuk perangkat pencetakan: tinggi halaman fisik, di unit perangkat. Misalnya, printer yang diatur untuk mencetak pada 600 dpi pada kertas 8,5-by-11-inci memiliki nilai tinggi fisik 6600 unit perangkat. Perhatikan bahwa halaman fisik hampir selalu lebih besar dari area halaman yang dapat dicetak, dan tidak pernah lebih kecil. | ||||||||||||||||||||||||||||||||||
|
Untuk perangkat pencetakan: jarak dari tepi kiri halaman fisik ke tepi kiri area yang dapat dicetak, di unit perangkat. Misalnya, printer yang diatur untuk mencetak pada 600 dpi pada kertas 8,5-by-11-inci, yang tidak dapat mencetak pada kertas paling kiri 0,25 inci, memiliki offset fisik horizontal 150 unit perangkat. | ||||||||||||||||||||||||||||||||||
|
Untuk perangkat pencetakan: jarak dari tepi atas halaman fisik ke tepi atas area yang dapat dicetak, di unit perangkat. Misalnya, printer yang diatur untuk mencetak pada 600 dpi pada kertas 8,5-by-11-inci, yang tidak dapat mencetak pada kertas paling atas 0,5 inci, memiliki offset fisik vertikal 300 unit perangkat. | ||||||||||||||||||||||||||||||||||
|
Untuk perangkat tampilan: laju refresh vertikal perangkat saat ini, dalam siklus per detik (Hz).
Nilai laju refresh vertikal 0 atau 1 mewakili laju refresh default perangkat keras tampilan. Laju default ini biasanya diatur oleh sakelar pada kartu tampilan atau motherboard komputer, atau oleh program konfigurasi yang tidak menggunakan fungsi tampilan seperti ChangeDisplaySettings. |
||||||||||||||||||||||||||||||||||
|
Faktor penskalaan untuk sumbu x printer. | ||||||||||||||||||||||||||||||||||
|
Faktor penskalaan untuk sumbu y printer. | ||||||||||||||||||||||||||||||||||
|
Perataan gambar horizontal pilihan, dinyatakan sebagai kelipatan piksel. Untuk performa gambar terbaik, jendela harus diselaraskan secara horizontal ke kelipatan nilai ini. Nilai nol menunjukkan bahwa perangkat dipercepat, dan perataan apa pun dapat digunakan. | ||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan bayangan dan perpaduan perangkat. Lihat Keterangan untuk komentar lebih lanjut.
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan raster perangkat, seperti yang ditunjukkan dalam tabel berikut.
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan kurva perangkat, seperti yang diperlihatkan dalam tabel berikut.
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan garis perangkat, seperti yang diperlihatkan dalam tabel berikut:
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan poligon perangkat, seperti yang diperlihatkan dalam tabel berikut.
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan teks perangkat, seperti yang diperlihatkan dalam tabel berikut.
|
||||||||||||||||||||||||||||||||||
|
Nilai yang menunjukkan kemampuan manajemen warna perangkat.
|
Mengembalikan nilai
Nilai yang dikembalikan menentukan nilai item yang diinginkan.
Ketika nIndex adalah BITSPIXEL dan perangkat memiliki 15bpp atau 16bpp, nilai yang dikembalikan adalah 16.
Keterangan
Ketika nIndex adalah SHADEBLENDCAPS:
- Untuk printer, GetDeviceCaps mengembalikan apa pun yang dilaporkan printer.
- Untuk perangkat tampilan, semua operasi penpaduan tersedia; selain SB_NONE, satu-satunya nilai yang dikembalikan adalah SB_CONST_ALPHA dan SB_PIXEL_ALPHA, yang menunjukkan apakah operasi ini dipercepat.
Catatan Display1 biasanya merupakan monitor utama, tetapi tidak selalu.
| Indeks | Pelarian printer diganti |
|---|---|
| PHYSICALWIDTH | GETPHYSPAGESIZE |
| PHYSICALHEIGHT | GETPHYSPAGESIZE |
| PHYSICALOFFSETX | GETPRINTINGOFFSET |
| PHYSICALOFFSETY | GETPHYSICALOFFSET |
| SCALINGFACTORX | GETSCALINGFACTOR |
| SCALINGFACTORY | GETSCALINGFACTOR |
CatatanGetDeviceCaps melaporkan info yang disediakan driver tampilan. Jika driver tampilan menolak untuk melaporkan info apa pun, GetDeviceCaps menghitung info berdasarkan perhitungan tetap. Jika driver tampilan melaporkan info yang tidak valid, GetDeviceCaps mengembalikan info yang tidak valid. Selain itu, jika driver tampilan menolak untuk melaporkan info, GetDeviceCaps mungkin menghitung info yang salah karena mengasumsikan DPI tetap (96 DPI) atau ukuran tetap (tergantung pada info yang dilakukan driver tampilan dan tidak menyediakan). Sayangnya, driver tampilan yang diimplementasikan ke Windows Display Driver Model (WDDM) (diperkenalkan di Windows Vista) menyebabkan GDI tidak mendapatkan info, sehingga GetDeviceCaps harus selalu menghitung info.
Contoh
Misalnya, lihat Bersiap mencetak.
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 | wingdi.h (sertakan Windows.h) |
| Pustaka | Gdi32.lib |
| DLL | Gdi32.dll |
Lihat juga
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk