New jack_free function added in jack.h.

git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@3532 0c269be4-1314-0410-8aa9-9f06e86f4224

ChangeLog

@@ -25,6 +25,10 @@ Paul Davis
   Jackdmp changes log
 ---------------------------
 
+2009-05-11 Stephane Letz  <letz@grame.fr>
+
+	* New jack_free function added in jack.h.
+
 2009-05-07 Stephane Letz  <letz@grame.fr>
 
 	* Cleanup "loopback" stuff in server.

common/JackAPI.cpp

@@ -241,6 +241,7 @@ extern "C"
 
     EXPORT jack_status_t jack_internal_client_unload (jack_client_t *client,
             jack_intclient_t intclient);
+    EXPORT void jack_free(void* ptr);
 
 #ifdef __cplusplus
 }
@@ -1930,3 +1931,8 @@ jack_get_version_string()
 {
     return VERSION;
 }
+
+EXPORT void jack_free(void* ptr)
+{
+    free(ptr);
+}

common/jack/jack.h

@@ -1070,6 +1070,16 @@ void jack_set_info_function (void (*func)(const char *));
 
 /*@}*/
 
+/**
+ * The free function to be used on memory returned by jack_port_get_connections, 
+ * jack_port_get_all_connections and jack_get_ports functions.
+ * This is MANDATORY on Windows when otherwise all nasty runtime version related crashes can occur.
+ * Developers are strongly encouraged to use this function instead of the standard "free" function in new code.
+ *
+ */
+void jack_free(void* ptr);
+
+
 #ifdef __cplusplus
 }
 #endif