Skip to content

Latest commit

 

History

History
116 lines (75 loc) · 3.69 KB

nf-wingdi-getdibcolortable.md

File metadata and controls

116 lines (75 loc) · 3.69 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:wingdi.GetDIBColorTable
GetDIBColorTable function (wingdi.h)
The GetDIBColorTable function retrieves RGB (red, green, blue) color values from a range of entries in the color table of the DIB section bitmap that is currently selected into a specified device context.
GetDIBColorTable
GetDIBColorTable function [Windows GDI]
_win32_GetDIBColorTable
gdi.getdibcolortable
wingdi/GetDIBColorTable
gdi\getdibcolortable.htm
gdi
3e3319be-8a3d-4ac2-ba36-9dbf18243472
12/05/2018
GetDIBColorTable, GetDIBColorTable function [Windows GDI], _win32_GetDIBColorTable, gdi.getdibcolortable, wingdi/GetDIBColorTable
wingdi.h
Windows.h
Windows
Windows 2000 Professional [desktop apps only]
Windows 2000 Server [desktop apps only]
Gdi32.lib
Gdi32.dll
Windows
19H1
GetDIBColorTable
wingdi/GetDIBColorTable
c++
APIRef
kbSyntax
DllExport
gdi32.dll
Ext-MS-Win-GDI-Draw-L1-1-2.dll
Ext-MS-Win-GDI-Draw-L1-1-3.dll
GDI32Full.dll
GetDIBColorTable

GetDIBColorTable function

-description

The GetDIBColorTable function retrieves RGB (red, green, blue) color values from a range of entries in the color table of the DIB section bitmap that is currently selected into a specified device context.

-parameters

-param hdc [in]

A handle to a device context. A DIB section bitmap must be selected into this device context.

-param iStart [in]

A zero-based color table index that specifies the first color table entry to retrieve.

-param cEntries [in]

The number of color table entries to retrieve.

-param prgbq [out]

A pointer to a buffer that receives an array of RGBQUAD data structures containing color information from the DIB color table. The buffer must be large enough to contain as many RGBQUAD data structures as the value of cEntries.

-returns

If the function succeeds, the return value is the number of color table entries that the function retrieves.

If the function fails, the return value is zero.

-remarks

The GetDIBColorTable function should be called to retrieve the color table for DIB section bitmaps that use 1, 4, or 8 bpp. The biBitCount member of a bitmap associated BITMAPINFOHEADER structure specifies the number of bits-per-pixel. DIB section bitmaps with a biBitCount value greater than eight do not have a color table, but they do have associated color masks. Call the GetObject function to retrieve those color masks.

-see-also

BITMAPINFOHEADER

Bitmap Functions

Bitmaps Overview

CreateDIBSection

DIBSECTION

GetObject

RGBQUAD

SetDIBColorTable