TCPIP_UDP_SignalHandlerRegister Function

TCPIP_UDP_SIGNAL_HANDLE TCPIP_UDP_SignalHandlerRegister(UDP_SOCKET s, TCPIP_UDP_SIGNAL_TYPE sigMask, TCPIP_UDP_SIGNAL_FUNCTION handler, const void* hParam); 

Returns a valid handle if the call succeeds, or a null handle if the call failed (null handler, no such socket, existent handler).

This function registers a UDP socket signal handler. The UDP module will call the registered handler when a UDP signal (TCPIP_UDP_SIGNAL_TYPE) occurs.

Only one signal handler per socket is supported. A new handler does not override the existent one. Instead TCPIP_UDP_SignalHandlerDeregister has to be explicitly called. The handler has to be short and fast. It is meant for setting an event flag, not for lengthy processing! The hParam is passed by the client but is currently not used and should be 0. For multi-threaded systems the TCP/IP packet dispatch does not occur on the user thread. The signal handler will be called on a different thread context. It is essential that this handler is non blocking and really fast. For multi-threaded systems, once set, it is not recommended to change the signal handler at run time. Synchronization between user threads and packet dispatch threads could be difficult. If really need to be changed, make sure that the old handler could still be called and it should be valid until the new one is taken into account. TCPIP_UDP_SignalHandlerDeregister needs to be called before registering another handler.

UDP valid socket.