## Presentation Device Driver Reference for OS/2

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

### OS2_PM_DRV_QUERYSCREENRESOLUTIONS Parameter - pcbBuf

pcbBuf (PULONG) - input Pointer to the number of bytes in the buffer.

pBuf Pointer to the buffer that receives the output from this function. The output is returned in a SCREENRESCOUNT structure followed by an array of SCREENRESOLUTION structures. pBuf should contain the following SCREENRESCOUNT information:

maxcount Total number of screen resolutions supported.

count Number of SCREENRESOLUTION structures returned. This count will be less than maxcount if the defined size of the pBuf buffer is too small as identified by pcbBuf.

res_struct_length Length of a SCREENRESOLUTION structure. This value should be used to increment between structures so that any future increase in the size of the structure (to add information) will not cause a failure.

The SCREENRESCOUNT information should be followed by the SCREENRESOLUTION information:

width Width of the device in pels.
height Height of the device in pels.
colors Number of colors supported in this mode.
planes Number of display planes in this mode.
floptions Optional information for each resolution.
Valid values include:
DSP_RESOLUTION_OBTAINABLE Obtainable with the hardware configuration
DSP_RESOLUTION_DEFAULT Default resolution for the hardware configuration

pcbBuf Pointer to the number of bytes in the pScreenResolution buffer. If pScreenResolution is 0 on input, this function stores the size (in bytes) needed to retrieve all of the screen resolution data in pcbScreenResolution . If not 0, this field contains the number of bytes actually returned.