## Presentation Device Driver Reference for OS/2

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

### GreEscape DEVESC_DEACQUIREFB

Select an item:

    Syntax
    Parameters
    Returns
    Glossary

Simulation support:

This function is mandatory for display drivers supporting software motion video. For other drivers, it is simulated by a handling routine in the graphics engine.

Description

GreEscape DEVESC_DEACQUIREFB releases the internal Presentation Manager driver resources acquired by DEVESC_ACQUIREFB. The escape results in the release of the video adapter device for use by other threads.

The device drivers are informed that the process that reserved the adapter has completed its operation.

This function is used in conjunction with DEVESC_SWITCHBANK and DEVESC_ ACQUIREFB. When used, the handling routine restores the state saved by DEVESC_ACQUIREFB and returns.

If DEVESC_ACQUIREFB had caused the mouse cursor to be hidden, this call will perform "unexclude" processing to restore the mouse cursor.

    #define INCL_GRE_DEVICE

    #include <os2.h>

    HDC      hdc;         /*  Device context handle. */

    LONG     lCode;       /*  DEVESC_DEACQUIREFB escape code. */

    LONG     lInCount;    /*  The handling routine ignores this parameter. */

    PBYTE    pbInData;    /*  The handling routine ignores this parameter. */

    PLONG    plOutCount;  /*  The handling routine ignores this parameter. */

    PLONG    pbOutData;   /*  The handling routine ignores this parameter. */

    LONG     rc;          /*  Return Code. */

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

           plOutCount, pbOutData);