VioSetFont

This call downloads a display font. The font being set must be compatible with the current mode.

VioSetFont

(RequestBlock, VioHandle)

RequestBlock (PVIOFONTINFO) - input

Address of the font structure containing the request:

length (USHORT)

Length of structure, including length.

14

Only valid value.
reqtype (USHORT)
Request type:

Type

Definition
0
Set current RAM font for EGA, VGA, or IBM Personal System/2 Display Adapter.
pelcolumns (USHORT)
Pel columns in character cell.
pelrows (USHORT)
Pel rows in character cell.
fonttable (PVOID)
Address of the data area containing font table to set.
tablelength (USHORT)
Length, in bytes, of the caller-supplied data area; must be 256 times the character cell height specified in pelrows.
VioHandle (HVIO) - input
Reserved word of 0s.
rc (USHORT) - return
Return code descriptions are:
• NO_ERROR 355
  ERROR_VIO_MODE
  421
  ERROR_VIO_INVALID_PARMS
  436
  ERROR_VIO_INVALID_HANDLE
  438
  ERROR_VIO_INVALID_LENGTH
  465
  ERROR_VIO_DETACHED
  467
  ERROR_VIO_FONT
  468
  ERROR_VIO_USER_FONT
  494
  ERROR_VIO_EXTENDED_SG
  Remarks

  VioSetFont is applicable only for the enhanced graphics adapter, VGA or IBM Personal System/2 Display Adapter.

  Note: Although graphics mode support is provided in VioSetFont, this support is not provided by the Base Video Handlers provided with OS/2.

  When VioSetFont is issued, the current code page is reset. If VioGetCp is subsequently issued, the error code ERROR_VIO_USER_FONT is returned. Return code, ERROR_VIO_USER_FONT represents a warning. It indicates that although the font could not be loaded into the adapter using the current mode, the font was saved as part of a special user font code page for use with a later VioSetMode. Successfully setting a user font sets the special user font code page, just as if a code page of -1 was specified using VioSetCp.

  The user font code page consists of the most recent user font of each size that was set by VioSetFont. For example, if two 8x12 fonts and three 8x16 fonts had been set, only two fonts, the most recent of the 8x12 and 8x16 fonts, would be saved.

  The special code page is used in the same way as those code pages specified on the CODEPAGE = statement in CONFIG.SYS.

  ---

  [Back: VioSetCurType]
  [Next: VioSetMode]