en:docs:fapi:viogetcp

This is part of Family API which allow to create dual-os version of program runs under OS/2 and DOS

Note: This is legacy API call. It is recommended to use 32-bit equivalent

2021/09/17 06:47 · prokushev
2021/08/20 05:18 · prokushev

VioGetCp

This call allows a process to query the code page currently used to display text data.

Syntax

 VioGetCp (Reserved, CodePageID, VioHandle)

Parameters

  • Reserved (USHORT) - input : A reserved word of 0s.
  • CodePageID (PUSHORT) - output : Address of a word in the application's data area. The current video code page is returned in this word.
  • VioHandle (HVIO) - input : This must be zero unless the caller is a Presentation Manager application, in which case it must be the value returned by VioGetPs.

Return Code

rc (USHORT) - return:Return code descriptions are:

  • 0 NO_ERROR
  • 355 ERROR_VIO_MODE
  • 436 ERROR_VIO_INVALID_HANDLE
  • 465 ERROR_VIO_DETACHED
  • 468 ERROR_VIO_USER_FONT

Remarks

The display code page ID previously set by VioSetCp, or inherited from the requesting process, is returned to the caller.

The code page tag returned is the currently active code page. A value of 0000 indicates that the code page in use is the ROM code page provided by the hardware.

If ERROR_VIO_USER_FONT is returned, it indicates a user font that was previously loaded with VioSetFont is the active code page.

Bindings

C

#define INCL_VIO
 
USHORT  rc = VioGetCp(Reserved, CodePageID, VioHandle);
 
USHORT  Reserved;      /* Reserved (must be zero) */
PUSHORT CodePageID;    /* Code page ID */
HVIO    VioHandle;     /* Video handle */
 
USHORT  rc;            /* return code */

MASM

EXTRN  VioGetCp:FAR
INCL_VIO            EQU 1
 
PUSH   WORD    Reserved      ;Reserved (must be zero)
PUSH@  WORD    CodePageID    ;Code page ID
PUSH   WORD    VioHandle     ;Video handle
CALL   VioGetCp
 
Returns WORD

Note


en/docs/fapi/viogetcp.txt · Last modified: 2021/10/14 09:19 by prokushev