VortexChannel* vortex_channel_pool_get_next_ready_full ( VortexChannelPool pool,
axl_bool  auto_inc,
axlPointer  user_data 
)

Allows to get the next channel available on the provided pool, providing a pointer that will be passed to the create channel handler.

This function works the same way like vortex_channel_pool_get_next_ready but allows to provide a pointer that is passed to the VortexChannelPoolCreate handler configured at vortex_channel_pool_new_full. In the case you didn't configure a creation channel handler, this function is not useful.

Once the channel was used, you should use vortex_channel_pool_release_channel to return the channel to the pool, making it usable by other invocation. The concept is to release the channel as soon as possible.

See vortex_channel_pool_get_next_ready function for more information.

Parameters:
pool The channel pool where a ready channel is required.
auto_inc axl_true to signal the function to create a new channel if there is not available.
user_data User defined data to be passed to the VortexChannelPoolCreate function.
Returns:
A newly allocated channel ready to use, or NULL if it fails.