use -Wl on -no-undefined as it is a linker option:
[oweals/gnunet.git] / src / include / gnunet_microphone_lib.h
index c99777d0ca3179e61348079de1356234aa886af8..def8418b7aac25b8fc4d880ac6bb445675870493 100644 (file)
@@ -1,17 +1,17 @@
 /*
   This file is part of GNUnet
   (C) 2013 Christian Grothoff (and other contributing authors)
-  
+
   GNUnet is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published
   by the Free Software Foundation; either version 3, or (at your
   option) any later version.
-  
+
   GNUnet is distributed in the hope that it will be useful, but
   WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   General Public License for more details.
-  
+
   You should have received a copy of the GNU General Public License
   along with GNUnet; see the file COPYING.  If not, write to the
   Free Software Foundation, Inc., 59 Temple Place - Suite 330,
@@ -36,6 +36,8 @@ extern "C"
 #endif
 #endif
 
+#include "gnunet_util_lib.h"
+
 /**
  * Process recorded audio data.
  *
@@ -53,10 +55,11 @@ typedef void (*GNUNET_MICROPHONE_RecordedDataCallback)(void *cls,
  * @param cls clsoure
  * @param rdc function to call with recorded data
  * @param rdc_cls closure for @a dc
+ * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
  */
-typedef void (*GNUNET_MICROPHONE_EnableCallback)(void *cls,
-                                                GNUNET_MICROPHONE_RecordedDataCallback rdc,
-                                                void *rdc_cls);
+typedef int (*GNUNET_MICROPHONE_EnableCallback)(void *cls,
+                                               GNUNET_MICROPHONE_RecordedDataCallback rdc,
+                                               void *rdc_cls);
 
 /**
  * Function that disables a microphone.
@@ -74,7 +77,7 @@ typedef void (*GNUNET_MICROPHONE_DestroyCallback)(void *cls);
 
 
 /**
- * A microphone is a device that can play or record audio data.
+ * A microphone is a device that can capture or otherwise produce audio data.
  */
 struct GNUNET_MICROPHONE_Handle
 {