Changeset 3643 for pjproject/branches/projects/2.0-dev/pjlib/include/pj/os.h

Timestamp:

Jul 14, 2011 8:46:19 AM (13 years ago)

Author:

ming

Message:

Re #1278: NSApplication and NSAutoreleasePool management for Mac OS X

Application now needs to call pj_run_app() from its main() function and pass a pointer to the application's main function. For some examples, please refer to aviplay, pjmedia_test, and pjsua.

File:

• pjproject/branches/projects/2.0-dev/pjlib/include/pj/os.h (modified) (1 diff)

pjproject/branches/projects/2.0-dev/pjlib/include/pj/os.h

@@ -1332 +1332 @@
 /* **************************************************************************/
 /**
+ * @defgroup PJ_APP_OS Application execution
+ * @ingroup PJ_OS
+ * @{
+ */
+
+/* Type for main function. */
+typedef int (*pj_main_func_ptr)(int argc, char *argv[]);
+
+/**
+ * Run the application. This function has to be called in the main thread
+ * and after doing the necessary initialization according to the flags
+ * provided, it will call main_func() function.
+ *
+ * @param main_func Application's main function.
+ * @param argc      Number of arguments from the main() function, which
+ *                  will be passed to main_func() function.
+ * @param argv      The arguments from the main() function, which will
+ *                  be passed to main_func() function.
+ * @param flags     Flags for application execution, currently must be 0.
+ *
+ * @return          main_func()'s return value.
+ */
+int pj_run_app(pj_main_func_ptr main_func, int argc, char *argv[],
+               unsigned flags);
+
+/** @} */
+
+
+/* **************************************************************************/
+/**
  * Internal PJLIB function to initialize the threading subsystem.
  * @return          PJ_SUCCESS or the appropriate error code.