## Display Device Driver Reference for OS/2

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

### GreEscape DEVESC_SETDRIVERCAPSVALUE

Select an item:

    Syntax
    Parameters
    Returns
    Glossary

Simulation support:

This function is optional for display drivers and has no simulation support .

Description:

GreEscape DEVESC_SETDRIVERCAPSVALUE will set the value that user has selected. The new value is specified in pCurrentValue.

When the Video Configuration Manager presents the interface to the user, each capability is presented in a separate window page of the capabilities notebook in System Object. The window layout depends on the capability type -Boolean type is represented by a check box and aggregate type is represented by a listbox. The capability description appears as the title for that control.

If the driver is going to support these capabilities in multiple languages, it must get the capability description (szCapsDesc) and capability aggreate strings, if applicable, from a resource module that contains already- translated strings.

    #define INCL_GRE_DEVICE

    #include <svgadefs.h>

    HDC      hdc;         /*  A handle to the device context. */

    LONG     lCode;       /*  DEVESC_SETDRIVERCAPSVALUE */

    LONG     lInCount;    /*  Number of bytes pointed to by pbInData. */

    PBYTE    pbInData;    /*  Pointer to a DRIVERCAPS data structure. */

    PLONG    plOutCount;  /*  Not used. */

    PBYTE    pbOutData;   /*  Not used. */

    LONG     rc;          /*  Return Code. */

    rc = GreEscape(hdc, lCode, lInCount, pbInData,

           plOutCount, pbOutData);