[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPCHMO - Set Choice Mode

GPCHMO (wsid, device, mode, echosw)

Purpose

Use GPCHMO to set the operating mode of a choice input device.

After the choice mode is set, its echoing state is set to 1=NOECHO or 2=ECHO based on the echosw parameter. Depending on the specified operating mode, 1=REQUEST, 2=SAMPLE, or 3=EVENT , an interaction with the given device may begin or end.

Note:

The input device is reset with the initialization values when the GPCHMO subroutine is called with mode parameters set to SAMPLE or EVENT.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

device -- specified by user, fullword integer

Choice device number.

mode -- specified by user, fullword integer

Operating mode (1=REQUEST, 2=SAMPLE, 3=EVENT )

echosw -- specified by user, fullword integer

Echo switch (1=NOECHO, 2=ECHO )

Error Codes

25
SPECIFIED WORKSTATION DOES NOT EXIST
140
DEVICE NUMBER < ONE OR DEVICE NOT AVAILABLE
168
INPUT DEVICE IS CURRENTLY OWNED BY ANOTHER CONNECTION
326
OPERATING MODE IS INVALID
327
ECHO SWITCH VALUE IS INVALID

Related Subroutines

GPAWEV
Await Event
GPINCH
Initialize Choice
GPQLI
Inquire List of Logical Input Devices
GPRQCH
Request Choice
GPSMCH
Sample Choice

RCP code

201335812 (X'0C002404')


[ Previous | Next | Contents | Glossary | Home | Search ]