QueryDeviceSurface: Difference between revisions
Created page with "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..." |
mNo edit summary |
||
| (4 intermediate revisions by one other user not shown) | |||
| Line 1: | Line 1: | ||
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. | 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. | 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== | ==Syntax== | ||
QueryDeviceSurface( | 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. | |||
[[Category: | [[Category:Presentation Device Driver Reference]] | ||
Latest revision as of 05:19, 28 December 2019
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.