getDIBColorTable 函数 (wingdi.h)

项目
03/13/2024

GetDIBColorTable 函数从当前选定到指定设备上下文的 DIB 节位图的颜色表中的一系列条目中检索 RGB (红、绿、蓝) 颜色值。

语法

UINT GetDIBColorTable(
  [in]  HDC     hdc,
  [in]  UINT    iStart,
  [in]  UINT    cEntries,
  [out] RGBQUAD *prgbq
);

参数

[in] hdc

设备上下文的句柄。必须在此设备上下文中选择 DIB 节位图。

[in] iStart

一个从零开始的颜色表索引，指定要检索的第一个颜色表条目。

[in] cEntries

要检索的颜色表条目数。

[out] prgbq

指向缓冲区的指针，该缓冲区接收 RGBQUAD 数据结构数组，其中包含 DIB 颜色表中的颜色信息。缓冲区必须足够大，才能包含与 cEntries 的值一样多的 RGBQUAD 数据结构。

返回值

如果函数成功，则返回值是函数检索的颜色表条目数。

如果函数失败，则返回值为零。

注解

应调用 GetDIBColorTable 函数来检索使用 1、4 或 8 bpp 的 DIB 节位图的颜色表。与 BITMAPINFOHEADER 结构的位图关联的 biBitCount 成员指定每像素的位数。 biBitCount 值大于 8 的 DIB 节位图没有颜色表，但它们具有关联的颜色掩码。调用 GetObject 函数以检索这些颜色掩码。

要求

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll