Changeset 6071 for pjproject/trunk/pjnath/include/pjnath/turn_sock.h

Timestamp:

Sep 23, 2019 7:25:41 AM (5 years ago)

Author:

ming

Message:

Fixed #2229: Limitations in ICE data sending

File:

• pjproject/trunk/pjnath/include/pjnath/turn_sock.h (modified) (2 diffs)

pjproject/trunk/pjnath/include/pjnath/turn_sock.h

@@ -87 +87 @@
                        const pj_sockaddr_t *peer_addr,
                        unsigned addr_len);
+
+    /**
+     * Notifification when asynchronous send operation has completed.
+     *
+     * @param turn_sock     The TURN transport.
+     * @param sent          If value is positive non-zero it indicates the
+     *                      number of data sent. When the value is negative,
+     *                      it contains the error code which can be retrieved
+     *                      by negating the value (i.e. status=-sent).
+     *
+     * @return              Application should normally return PJ_TRUE to let
+     *                      the TURN transport continue its operation. However
+     *                      it must return PJ_FALSE if it has destroyed the
+     *                      TURN transport in this callback.
+     */
+    pj_bool_t (*on_data_sent)(pj_turn_sock *sock,
+                              pj_ssize_t sent);
 
     /**
@@ -575 +592 @@
  * @param addr_len      Length of the address.
  *
- * @return              PJ_SUCCESS if the operation has been successful,
- *                      or the appropriate error code on failure.
+ * @return              PJ_SUCCESS if data has been sent immediately, or
+ *                      PJ_EPENDING if data cannot be sent immediately. In
+ *                      this case the \a on_data_sent() callback will be
+ *                      called when data is actually sent. Any other return
+ *                      value indicates error condition.
  */ 
 PJ_DECL(pj_status_t) pj_turn_sock_sendto(pj_turn_sock *turn_sock,