gpr_get_ec(A) — Apollo

GPR_$GET_EC                       GPR Calls                        GPR_$GET_EC


NAME
     gpr_$get_ec - returns the eventcount associated with a graphic event.

FORMAT
     gpr_$get_ec (gpr_key, eventcount_pointer, status)

DESCRIPTION
     This routine returns the eventcount associated with a graphic event.

     gpr_$get_ec returns the eventcount pointer for the graphics input
     eventcount, which is advanced whenever graphics input may be available.

     When this eventcount is advanced, it does not guarantee that
     gpr_$cond_event_wait will return an event, or that gpr_$event_wait will
     not wait.  The advance is merely an optimization of a simple polling loop
     that suspends execution of the process until an event might be available.

   Input Parameters
     gpr_key
          The key that specifies which eventcount to obtain, in gpr_$ec_key_t
          format.  Currently, this key is always gpr_$input_ec.

   Output Parameters
     eventcount_pointer
          A pointer to the eventcount for graphics input, in ec2_$ptr_t for-
          mat.

     status
          Completion status, in status_$t format.
Museum
