## Presentation Device Driver Reference for OS/2

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

### GreEscape DEVESC_ACQUIREFB - Parameters

hdc (HDC) - input Device context handle.

ICODE (LONG) - input DEVESC_ACQUIREFB escape code.

lInCount (LONG) - input Number of bytes pointed to by pInData.

pbInData (PBYTE) - input Pointer to ACQUIREFB structure containing:

fAFBFlags Only one flag is currently defined. AFB_SWITCH is set if the ulBankNumber field contains the value of a bank switch, which is to be active when the call returns. AFB_SWITCH should not be set for apertures that are not bank-switched.

ulBankNumber This is an integer value specifying the initial video memory bank index; 0 (zero) for the first bank, 1 (one) for the second bank, and so on.

rctlRegion This field gives the rectangle, in device coordinates, that will be used for "BLTing".

The device driver will perform "Exclude" processing to hide the mouse cursor if it is in this area. If it is hidden when DEVESC_DEACQUIREFB is called, it will be restored.

plOutCount (PLONG) - input The handling routine ignores this parameter.

pbOutData (PLONG) - input The handling routine ignores this parameter.

rc (LONG) - returns Return Code.

The handling routine returns:

DEV_OK Successful
DEVESC_NOTIMPLEMENTED Escape is not implemented for the specified code
DEVESC_ERROR Error