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 操作系统。
目标平台	通用
标头	winddi.h (包括 Winddi.h)
Library	Win32k.lib
DLL	Win32k.sys

另请参阅

XLATEOBJ