QueryDeviceSurface

QueryDeviceSurface provides the needed information to the graphics engine for handling the new Device Driver Interface (DDI) architecture.

This routine is used by the graphics engine to query the device surface information. This function fills the DEVICESURFACE structure to be used by both the graphics engine and the device driver.

Required by the OS/2 graphics engine (version 2.2 and later). Gives engine description of raster surface and performs some modifications to the device surface structure.

Syntax

QueryDeviceSurface(ulSubfunction, pParam1, pParam2);

Parameters

ulSubfunction (ULONG) - input

0Eh.

pParam1 (PLONG) - input

Pointer to the DEVICESURFACE data structure.

Points to information needed by the graphics engine.

pParam2 (LONG) - input

Long integer returned from FillPhysicalDeviceBlock.

Return Code

rc (LONG) - returns

Return codes.

The handling routine should return a LONG integer. Valid values are:

• Zero (0) Success
• - 1 Error

If pParam1 is a null pointer, return a zero (0) if you are requesting new graphics engine support; otherwise, return a - 1.

Remarks

For display drivers, the system layer is responsible for handling the QueryDeviceSurface subfunction call. This call is made from the graphics engine during an OpenDC request.