VioSetMode

Sets the mode of the display.

Syntax
VioSetMode (ModeData, VioHandle)

Parameters

 * ModeData (PVIOMODEINFO) - input: Mode characteristics.
 * Address of the mode characteristics structure.


 * VioHandle (HVIO) - input: VIO presentation-space handle.
 * This must be 0, unless the caller is a Presentation Manager application; in this case, it must be the value returned by VioCreatePS.

Return Code

 * rc (APIRET) - returns:VioSetMode returns one of the following values:
 * 0 NO_ERROR
 * 355 ERROR_VIO_MODE
 * 421 ERROR_VIO_INVALID_PARMS
 * 430 ERROR_VIO_ILLEGAL_DURING_POPUP
 * 436 ERROR_VIO_INVALID_HANDLE
 * 438 ERROR_VIO_INVALID_LENGTH
 * 467 ERROR_VIO_FONT

Remarks
VioSetMode initializes the cursor position and type.

VioSetMode does not clear the screen if the new and old modes are compatible. To clear the screen, use one of the VioScrollxx calls.

Assuming that no target display configuration for VioSetMode is selected, the mode is set on the primary configuration. If the primary configuration does not support the specified mode, the mode is set on the secondary configuration.