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
The handling routine should return a LONG integer. Valid values are: If pParam1 is a null pointer, return a zero (0) if you are requesting new graphics engine support; otherwise, return a - 1.
 * rc (LONG) - returns: Return codes.
 * Zero (0) Success
 * - 1 Error

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.