## Presentation Device Driver Reference for OS/2

[prev][next][parent][TOC]

### GreQueryRealColors

Select an item:

    Syntax
    Parameters
    Returns
    Glossary

Simulation support:

None. This function is mandatory for all drivers.

Description:

GreQueryRealColors stores, in the array addressed by pArray, the RGB values of the distinct colors available on the currently associated device.

This function must be supported by the presentation driver. GreQueryRealColors is called by GpiQueryRealColors in response to an application requesting the currently available colors for the device context.

    #define INCL_GRE_COLORTABLE

    #include <os2.h>

    HDC      hdc;        /*  Device context handle. */

    ULONG    flOptions;  /*  Options flag. */

    LONG     lStart;     /*  Ordinal number of the first color required. */

    LONG     cArray;     /*  Number of elements available in the array. */

    PLONG    pArray;     /*  Pointer to array in which data is returned. */

    PVOID    pInstance;  /*  Pointer to instance data. */

    ULONG    lFunction;  /*  High-order WORD=flags; low-order WORD=NGreQueryRealColors. */

    LONG     rc;         /*  Return Code. */

    rc = GreQueryRealColors(hdc, flOptions, lStart,

           cArray, pArray, pInstance, lFunction);