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

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

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也會傳回零。

備註

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

規格需求

另請參閱

XLATEOBJ