gpr_set_input_sid(A) — Apollo Domain/OS SR10.4

GPR_$SET_INPUT_SID                GPR Calls                 GPR_$SET_INPUT_SID


NAME
     gpr_$set_input_sid - specifies the input pad for graphics input.

FORMAT
     gpr_$set_input_sid (stream_id, status)

DESCRIPTION
     This routine specifies the input pad from which graphics input is to be
     taken.

   Input Parameters
     stream_id
          The stream-id that GPR software will use for input in frame mode, in
          stream_$id_t format.  The stream must be a Display Manager input
          pad.

   Output Parameters
     status
          Completion status, in status_$t format.

NOTES
     Programs use this call only when they call input routines in  frame  mode
     (gpr_$event_wait and gpr_$cond_event_wait).

     If this routine is not called, the default stream ID is stream_$stdin  (a
     stream id of zero).

     To work properly, the input pad must be the pad associated with the tran-
     script  pad  passed  to  gpr_$init.   stream_$stdin  is  associated  with
     stream_$stdout in this way in a normal Shell process window.  Other  pro-
     cess  input  pads derive their association from the pad_$create call that
     created them.
Museum
