VioWrtTTY

Writes the string to the display, with the current cursor position as the starting point. When the write is finished, the cursor is moved to one position past the end of the string.

Syntax
VioWrtTTY (CharStr, Length, VioHandle)

Parameters

 * CharStr (PCH) - input: Character string to be written. The address of the string to be written.
 * Length (ULONG) - input: Length of the character string in bytes.
 * VioHandle (HVIO) - input: VIO presentation-space handle.
 * This value is to be zero, unless the caller is a Presentation Manager application. If this is the case, the value need to be from VioCreatePS.

Returns
APIRET with values of:
 * 0 NO_ERROR
 * 355 ERROR_VIO_MODE
 * 421 ERROR_VIO_INVALID_PARMS
 * 436 ERROR_VIO_INVALID_HANDLE

Define (C/C++)
INCL_VIO

Calling Convention
Cdecl32

Example Code
PCH    string; ULONG strLength; HVIO  videoHndl; APIRET rc; ... rc = VioWrtTTY(string, strLength, videoHndl); ...

Remarks
If a string write gets to the end of the line and is not complete, the string write continues at the beginning of the next line. If the write gets to the end of the screen, the screen is scrolled, and the write continues until completed.

The character's carriage return, line feed, backspace, tab, and bell are treated as commands rather than printable characters. Backspace is a nondestructive backspace. Tabs are expanded to provide standard 8-byte-wide fields. VioWrtTTY is the only video function affected by ANSI.

Characters are written using the current attribute defined by ANSI or the default value of 7.