Synchronous handler definition used by the channel pool module to create a new channel.
This function allows to notify the user code that a new channel must be created for the channel pool. This allows to place the channel creation code outside the channel pool module while the channel pool features remain the same.
The function has pretty much the same parameters as vortex_channel_new, which is quite straightforward, but two additional parametes are provided: create_channel_user_data and get_next_data. Both a pointers that are defined at the vortex_channel_pool_new_full in the first case, and at the vortex_channel_pool_get_next_ready_full.
See vortex_channel_pool_new_full for more information.
|connection ||The connection where the channel pool is asking to createa a new channel.|
|channel_num ||The channel number to create.|
|profile ||The profile for the channel.|
|on_close ||The on close handler to be executed once received a close notification.|
|on_close_user_data ||The on close handler user data (data provided to the on close handler).|
|on_received ||The frame received handler to be executed one data is received. Once the channel is created and returned by vortex_channel_pool_get_next_ready or vortex_channel_pool_get_next_ready_full this value can be reconfigured using vortex_channel_set_received_handler.|
|on_received_user_data ||User defined data to be passed to the handler.|
|create_channel_user_data ||User defined data provided at the channel pool creation function.|
- A newly created VortexChannel reference or NULL if it fails.