winddi.h () XLATEOBJ_cGetPalette 函数

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