VioSetFont
Bindings: C, MASM
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:
0 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.
Created using Inf-PHP v.2 (c) 2003 Yuri Prokushev
Created using Inf-HTML v.0.9b (c) 1995 Peter Childs