summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--src/canberra.h4
1 files changed, 3 insertions, 1 deletions
diff --git a/src/canberra.h b/src/canberra.h
index f964f3a..493cc99 100644
--- a/src/canberra.h
+++ b/src/canberra.h
@@ -121,7 +121,9 @@
typedef struct ca_context ca_context;
/** Playback completion event callback. This callback will be called
- * from a background thread. */
+ * from a background thread. The code implementing this function may
+ * not call any libcanberra API call from this callback -- this might
+ * result in a deadlock. */
typedef void (*ca_finish_callback_t)(ca_context *c, uint32_t id, int error_code, void *userdata);
/** Error codes */