NAME
          irWCheck - wait and get event information

     SYNOPSIS
          #include <irapi.h>

          int irWCheck (ir_event_t *pir_event);

     DESCRIPTION
          The irWCheck function combines irWait(3IRAPI) and
          irCheck(3IRAPI) as a convenience to the user.  irWCheck is a
          blocking function used to access events.

          The events and event structure (ir_event_t) are specified in
          IrEVENTS(4IRAPI).

          irWCheck returns information about only one event.  If mul-
          tiple events are queued, irWCheck returns the first one.

          irWCheck returns if there is an enabled event on the event
          queue. It blocks if there is no enabled event on the event
          queue.

          irWCheck never returns for IRE_NULL events.

     EVENT
          No event results from the call to irWCheck.

     RETURN VALUE
          irWCheck returns the event_id if successful [see
          IrEVENTS(4IRAPI)].

          IRR_FAIL is returned if an error occurs.

     ERROR
          Error strategies as defined for irWait apply for irWCheck.

     CAVEAT
          The application must call function irWCheck or
          irWait(3IRAPI) soon after initiating one or more asynchro-
          nous speech functions to ensure proper handling of the
          speech at the driver level.

     SEE ALSO
          irWait(3IRAPI), irCheck(3IRAPI)

     VERSION
          This is version 11/25/02 of this man page.