Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileV_Opnwk()
v_opnvwk()
vq_extnd()
v_opnwk()                                                               VDI

Syntax

VOID v_opnwk( work_in, handle, work_out )
WORD *work_in, *handle, *work_out;

Function      v_opnwk() opens a physical workstation.

Opcode        1

Availability  Available only with some form of GDOS.

Parameters    All parmeters for this function are consistent with
              v_opnvwk() except as follows:

              On entry, handle does not need to contain any specific
              value. For screen devices you should normally use the value
              Getrez() + 2 for the work_in[0] field, however, a value of
              1 is acceptable if not using any loaded fonts.
              On return, however, it will contain a workstation handle if
              successful or 0 if the call failed.

Binding       WORD i;

              contrl[0] = 1;
              contrl[1] = 0;
              contrl[3] = 11;

              for(i = 0;i < 11;i++)
               intin[i] = work_in[i];

              vdi();

              *handle = contrl[6];

              for(i = 0;i < 45;i++)
               work_out[i] = intout[i];

              for(i = 0;i < 13;i++)
               work_out[45+i] = ptsout[i];

Comments      Physical workstations should be opened when needed and
              closed immediately afterwards. For example, a word processor
              should not open the printer workstation when the application
              starts and close it when it ends. If this is done, the user
              will be unable to change printers with the Printer Setup
              CPX(s).

See Also      V_Opnwk(), v_opnvwk(), vq_extnd()

Group         VDI Workstation