The application should call this routine whenever a read event is signaled on a file descriptor returned by rapi_getfd(). The rapi_dispatch() routine can be called at any time, but it will generally have no effect unless there is a pending event.