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()
vq_extnd()
v_opnvwk()
V_Opnvwk()
V_Opnwk()                                                               VDI

Syntax

WORD V_Opnwk( devno, dev )
WORD devno; dev
VDI_Workstation dev;

Function      V_Opnwk() is not a component of the VDI, rather an interface
              binding designed to simplify working with VDI workstations.
              It will open a physical workstation using a VDI_Workstation
              structure rather than work_in and work_out.

Opcode        N/A

Availability  User-defined.

Parameters    devno specifies the device ID of the device to open. Valid
              values for devno follow:

               1-10   Screen (loaded device drivers only)
              11-20   Plotters
              21-30   Printers
              31-40   Metafile Drivers
              41-50   Camera Drivers
              51-60   Tablet Drivers
              61-70   Memory Driversws is a VDI_Workstation structure
                      as defined in V_Opnvwk().

Binding       WORD
              V_Opnvwk( devno, dev )
              WORD devno;
              VDI_Workstation dev;
              {
               WORD i, in[11];

               in[0] = dev->dev_id = devno;
               for(i = 1;i < 10; in[i++] = 1);
               in[10] = 2;
               i = devno;

               v_opnvwk( in, &i, &dev->xres );
               dev->handle = i;

               if(i)
                vq_extnd( i, 1, &dev->screentype );

               return (i);
              }

Return Value  V_Opnwk() returns a workstation handle if successful or 0 if
              the call failed.

Comments      This function definition is adapted from an article which
              appeared in the 'Atari .RSC' developers newsletter
              (Nov '90 - Jan '91).

See Also      v_opnwk(), vq_extnd(), v_opnvwk(), V_Opnvwk()

Group         VDI Workstation