Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File7.7.25  vsin_mode                                                  TOS

 Name:         »Set input mode« - Switch between REQUEST and SAMPLE 
               mode.

 Opcode:       33

 Syntax:       int16_t vsin_mode ( int16_t handle, int16_t dev_type, 
               int16_t mode );

 Description:  The call vsin_mode sets the input mode to REQUEST or 
               SAMPLE for the specified device.

                Parameter  Meaning

                handle     Workstation identifier
                dev_type   Type of input device:
                            1 =     Position input (mouse)
                            2 =     Value-altering devices (cursor)
                            3 =     'Choice' devices (function keys)
                            4 =     Alphanumeric devices (keyboard)
                mode       Requested input mode:
                            1 =     Request
                            2 =     Sample

               In REQUEST mode the input device waits for an input, in 
               SAMPLE mode only the status of the position of the 
               input device will be returned.

               Notes: The input functions of the VDI work only on the 
               physical workstation, which is normally used by the 
               AES.

               Using this function will cause the AES to operate 
               improperly!

 Return value: The function returns the selected input mode.

 Availability: Supported in ROM by all Atari computers.

 Group:        Input functions

 See Also:     Binding