Changeset 4887 for pjproject/trunk/pjsip/include/pjsua2/endpoint.hpp

Timestamp:

Aug 13, 2014 9:14:53 AM (10 years ago)

Author:

nanang

Message:

Close #1779: Add APIs for external/native thread registration to pjsua2: Endpoint::libRegisterThread() & Endpoint::libIsThreadRegistered().

File:

• pjproject/trunk/pjsip/include/pjsua2/endpoint.hpp (modified) (3 diffs)

pjproject/trunk/pjsip/include/pjsua2/endpoint.hpp

@@ -28 +28 @@
 #include <pjsua2/siptypes.hpp>
 #include <list>
+#include <map>
 
 /** PJSUA2 API is inside pj namespace */
@@ -722 +723 @@
 
     /**
-     * Register a thread to poll for events. This function should be
-     * called by an external worker thread, and it will block polling
-     * for events until the library is destroyed.
-     */
-    void libRegisterWorkerThread(const string &name) throw(Error);
+     * Register a thread that was created by external or native API to the
+     * library. Note that each time this function is called, it will allocate
+     * some memory to store the thread description, which will only be freed
+     * when the library is destroyed.
+     *
+     * @param name      The optional name to be assigned to the thread.
+     */
+    void libRegisterThread(const string &name) throw(Error);
+
+    /**
+     * Check if this thread has been registered to the library. Note that
+     * this function is only applicable for library main & worker threads and
+     * external/native threads registered using libRegisterThread().
+     */
+    bool libIsThreadRegistered();
 
     /**
@@ -1173 +1184 @@
     AudDevManager                audioDevMgr;
     CodecInfoVector              codecInfoList;
+    std::map<pj_thread_t*, pj_thread_desc*> threadDescMap;
 
     /* Pending logging */