XLATEOBJ_cGetPalette函式 (winddi.h)

XLATEOBJ_cGetPalette函式會從指定的調色盤擷取 RGB 色彩或位字段格式。

語法

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

參數

pxlo

GDI 從中擷取要求資訊的 XLATEOBJ 結構的指標。

[in] iPal

識別要寫入的調色盤資訊。 此參數可以是下列其中一個值：

值	意義
XO_DESTBITFIELDS	GDI 會擷取目的地調色盤的位字段格式。
XO_DESTPALETTE	GDI 會從目的地調色盤擷取 RGB 色彩。
XO_SRCBITFIELDS	GDI 會擷取來源調色盤的位字段格式。
XO_SRCPALETTE	GDI 會從來源調色盤擷取 RGB 色彩。

cPal

指定 pPal 所指向之緩衝區中的項目數目。 這可以小於調色盤的總大小。

pPal

GDI 寫入要求調色盤信息的緩衝區指標。 如果 iPal 是XO_SRCPALETTE或XO_DESTPALETTE，且個別調色盤類型是PAL_INDEXED，則每個專案都是 24 位 RGB 值。

如果 iPal 是XO_SRCBITFIELDS或XO_DESTBITFIELDS，而個別調色盤類型是PAL_BITFIELDS、PAL_RGB或 PAL_BGR，pPal 會指向代表紅色、綠色和藍色遮罩的三個 ULONG 遮罩。

傳回值

XLATEOBJ_cGetPalette 傳回 pPal 不是 Null 時所寫入的項目數。 如果 XLATEOBJ 為 Null 或其調色盤無效，則會傳回零的值。 如果pxlo 所指向的數據與 iPal 中的值不一致，XLATEOBJ_cGetPalette也會傳回零。 例如，如果指向的數據是位字段，但 iPal 會設定為 XO_SRCPALETTE 或 XO_DESTPALETTE，XLATEOBJ_cGetPalette 會傳回零。 同樣地，如果 pxlo 所指向的數據是調色盤，但 iPal 會設定為 XO_SRCBITFIELDS 或 XO_DESTBITFIELDS，XLATEOBJ_cGetPalette也會傳回零。

備註

驅動程式必須有調色盤的相關信息，才能執行色彩混合的一些方法。

規格需求

需求	值
最低支援的用戶端	可在 Windows 2000 和更新版本的 Windows 作業系統中使用。
目標平台	Universal
標頭	winddi.h (包括 Winddi.h)
程式庫	Win32k.lib
Dll	Win32k.sys

另請參閱

XLATEOBJ