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

REQUEST CHOICE (PHOP,WSOP,*,*)

Purpose

Use Request Choice to have the graPHIGS API execute a request to the specified choice device. The graPHIGS API returns the choice input value, which is the current measure of the choice device.

A status of NONE means that a break action occurred. If the measure of the choice device indicates no choice, then the graPHIGS API returns a status of NOCHOICE. Otherwise, the graPHIGS API returns a status of OK together with a choice number which the graPHIGS API sets according to the current measure of the choice device.

Language Bindings

C

preq_choice (ws_id, choice_num, in_status, choice)

Input Parameters

Pint ws_id
Workstation identifier.

Pint choice_num
Choice device number (>=1).

Output Parameters

Pin_status *in_status
Choice status (0=PIN_STATUS_NONE, 1=PIN_STATUS_OK, 2=PIN_STATUS_NO_IN).

Pint *choice
Requested choice.

FORTRAN

PRQCH (wkid, chdnr, stat, chnr)

Input Parameters

integer wkid
Workstation identifier.

integer chdnr
Choice device number (>=1).

Output Parameters

integer stat
Choice status (0=PNONE, 1=POK, 2=PNCHOI).

integer chnr
Choice number (>=1).

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
61
Specified Workstation Is Not Of Category Input Or Outin
250
Specified Device Not Available On Workstation
251
Function Requires Input Device To Be In Request Mode

Related Subroutines

  • Initialize Choice

  • Inquire Number Of Available Logical Input Devices

  • Set Choice Mode

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