[Toc][Index]

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