## Presentation Device Driver Reference for OS/2

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

### DspDefaultResolution - Parameters

pScreenResolution (PSCREENRESOLUTION) - input If flOptions==DSP_SET_DEFAULT _RESOLUTIONS, this parameter points to ScreenResolution structure to be saved to the INI file. If not, this parameter points to the buffer that receives the default values currently saved in the INI file.

pcbScreenResolution (PULONG) - input Points to the count of bytes in the pScreenResolution buffer. If pScreenResolution is NULL on input, the function will store the count of bytes needed to store all of the resolution data in pcbScreenResolution. If not ZERO, upon return, that field contains the number of bytes actually returned.

flOptions (ULONG) - input Used to specify whether to SET or QUERY the default resolution. If flOptions==DSP_SET_DEFAULT_RESOLUTIONS, the values are SET (written) in the INI file. Otherwise, the INI file is QUERYED.

DSP_RESOLUTION_OBTAINABLE Default resolution is obtained from the current hardware configuration.

DSP_RESOLUTION_DEFAULT This is a default resolution.

Example of structure pointed to by pScreenResolution:

         typedef struct _SCREENRESOLUTION {

            ULONG width;    /* width of the device in pels             */

            ULONG height;   /* height of the device in pels            */

            ULONG colors;   /* number of colors supported in this mode */

            ULONG planes;   /* number of display planes in this mode   */

            ULONG flOptions /* identifies optional information for each resolution*/

         } SCREENRESOLUTION;

         typedef SCREENRESOLUTION *PSCREENRESOLUTION;

fSuccess (ULONG) - returns Return codes.

On completion, this installation routine must return BOOLEAN (fSuccess).

TRUE Success
FALSE Error