XLATEOBJ_cGetPalette (winddi.h)

Artikel
03/04/2024

Fungsi XLATEOBJ_cGetPalette mengambil warna RGB atau format bitfields dari palet yang ditentukan.

Sintaks

ENGAPI ULONG XLATEOBJ_cGetPalette(
       XLATEOBJ *pxlo,
  [in] ULONG    iPal,
       ULONG    cPal,
       ULONG    *pPal
);

Parameter

pxlo

Arahkan ke struktur XLATEOBJ tempat GDI mengambil informasi yang diminta.

[in] iPal

Mengidentifikasi informasi palet yang akan ditulis. Parameter ini bisa menjadi salah satu nilai berikut:

Nilai	Makna
XO_DESTBITFIELDS	GDI mengambil format bitfields dari palet tujuan.
XO_DESTPALETTE	GDI mengambil warna RGB dari palet tujuan.
XO_SRCBITFIELDS	GDI mengambil format bitfields dari palet sumber.
XO_SRCPALETTE	GDI mengambil warna RGB dari palet sumber.

cPal

Menentukan jumlah entri dalam buffer yang diacu oleh pPal. Ini bisa lebih kecil dari ukuran total palet.

pPal

Penunjuk ke buffer tempat GDI menulis informasi palet yang diminta. Jika iPal XO_SRCPALETTE atau XO_DESTPALETTE dan jenis palet masing-masing PAL_INDEXED, setiap entri adalah nilai RGB 24-bit.

Jika iPal XO_SRCBITFIELDS atau XO_DESTBITFIELDS dan jenis palet masing-masing PAL_BITFIELDS, PAL_RGB, atau PAL_BGR, pPal menunjuk ke tiga masker ULONG yang mewakili masker warna merah, hijau, dan biru.

Nilai kembali

XLATEOBJ_cGetPalette mengembalikan jumlah entri yang ditulis jika pPal tidak null. Nilai nol dikembalikan jika XLATEOBJ null atau paletnya tidak valid. XLATEOBJ_cGetPalette juga akan mengembalikan nol jika data yang diacu oleh pxlo tidak konsisten dengan nilai di iPal. Misalnya, jika data yang ditujukan ke adalah bitfield, tetapi iPal diatur ke XO_SRCPALETTE atau XO_DESTPALETTE, XLATEOBJ_cGetPalette akan mengembalikan nol. Demikian pula, jika data yang ditujukan oleh pxlo adalah palet, tetapi iPal diatur ke XO_SRCBITFIELDS atau XO_DESTBITFIELDS, XLATEOBJ_cGetPalette juga mengembalikan nol.

Keterangan

Driver harus memiliki informasi tentang palet untuk melakukan beberapa metode perpaduan warna.

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

Lihat juga

XLATEOBJ

Bagikan melalui