Remove a file descriptor from the active channel.
BPS_API int bps_remove_fd(int fd)
The file descriptor to remove.
The function is called when a service wants to remove a file descriptor from the channel's set of file descriptors that it is monitoring for input or output.
If the file descriptor is present it is removed from the channel. The io_handler callback and associated user data are also removed.
Typically, the function is used in services that provide a function to stop events from arriving on the channel's event queue.
BPS_SUCCESS if the fd (file descriptor) was successfully removed from the channel, BPS_FAILURE with errno value set otherwise.