Fungsi EngQueryPalette (winddi.h)
Fungsi EngQueryPalette meminta palet yang ditentukan untuk atributnya.
Sintaks
ENGAPI ULONG EngQueryPalette(
HPALETTE hpal,
ULONG *piMode,
ULONG cColors,
ULONG *pulColors
);
Parameter
hpal
Tangani ke palet yang akan dikueri.
piMode
Arahkan ke lokasi yang menerima mode palet, seperti yang semula ditentukan dalam EngCreatePalette.
cColors
Menentukan jumlah entri dalam buffer tempat pulColors menunjuk. Nilai yang dikembalikan tergantung pada apakah kolor negatif.
pulColors
Penunjuk ke buffer yang menerima informasi warna palet. Jika cColors adalah nol, pulColors dapat berupa NULL.
Nilai kembali
Ketika cColors adalah nol, EngQueryPalette mengembalikan jumlah entri palet yang diperlukan dalam buffer tempat pulColors menunjuk untuk mengembalikan informasi warna palet. Ketika cColors bukan nol dan pulColors bukan NULL, EngQueryPalette mengembalikan jumlah entri yang ditulis dalam buffer tempat pulColors menunjuk.
Keterangan
Jika mode palet PAL_BITFIELDS, PAL_RGB, atau PAL_BGR dan buffer yang ditunjukkan pulColors cukup besar, pulColors menunjuk ke tiga topeng ULONG yang mewakili topeng warna merah, hijau, dan biru palet.
Jika mode palet PAL_INDEXED dan buffer yang ditunjukkan pulColors cukup besar, pulColors berisi semua nilai RGB 24-bit yang mewakili warna palet.
Driver harus menguji keberadaan bendera GCAPS_PALMANAGED untuk menentukan apakah warna mewakili palet tetap atau dapat diubah.
EngQueryPalette ditujukan untuk digunakan dengan mencerminkan driver yang perlu mengetahui format warna tampilan utama. Driver pencerminan biasanya memanggil fungsi ini dalam rutinitas DrvEnablePDEV-nya .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows. |
| Target Platform | Universal |
| Header | winddi.h (termasuk Winddi.h) |
| Pustaka | Win32k.lib |
| DLL | Win32k.sys |