Dispatcher Functions (TipcDispatcher*)

TipcDispatcher* functions allow the managing messages from multiple RTserver connections with a single call. This is especially useful in single threaded RTclients. By adding one or more RTserver connections to a dispatcher to using TipcDispatcherSrvAdd, a single TipcDispatcherMainLoop call is equivalent to calling TipcSrvConnMainLoop on each of the RTserver connections simultaneously.

The dispatcher not only manages messages arriving on RTserver connections, but it can also manage events.

TipcDispatcherCreate — create a dispatcher

T_IPC_DISPATCHER TipcDispatcherCreate() 

TipcDispatcherCreateDetached — create a dispatcher in a detached thread

T_IPC_DISPATCHER TipcDispatcherCreateDetached() 

TipcDispatcherDestroy — destroy a dispatcher

T_BOOL TipcDispatcherDestroy(dispatcher) 
T_IPC_DISPATCHER dispatcher; 

TipcDispatcherDispatch — dispatch triggered events within timeout seconds and exit

T_BOOL TipcDispatcherDispatch(dispatcher, timeout) 
T_IPC_DISPATCHER dispatcher; 
T_REAL8 timeout; 

TipcDispatcherMainLoop — dispatch events continuously for timeout seconds

T_BOOL TipcDispatcherMainLoop(dispatcher, timeout) 
T_IPC_DISPATCHER dispatcher; 
T_REAL8 timeout; 

TipcDispatcherSrvAdd — add RTserver connection to a dispatcher

T_BOOL TipcDispatcherSrvAdd(dispatcher, srv) 
T_IPC_DISPATCHER dispatcher; 
T_IPC_SRV srv; 

TipcDispatcherSrvRemove — remove RTserver connection from a dispatcher

T_BOOL TipcDispatcherSrvRemove(dispatcher, srv) 
T_IPC_DISPATCHER dispatcher; 
T_IPC_SRV srv;