Changeset 3664 for pjproject/trunk/pjlib/include/pj/os.h

Timestamp:

Jul 19, 2011 3:42:28 AM (13 years ago)

Author:

nanang

Message:

Re #1326: Initial code integration from branch 2.0-dev to trunk as "2.0-pre-alpha-svn".

Location:

pjproject/trunk

Files:

• . (modified) (1 prop)
• pjlib/include/pj/os.h (modified) (1 diff)

pjproject/trunk/pjlib/include/pj/os.h

@@ -1435 +1435 @@
 /* **************************************************************************/
 /**
+ * @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.