Sanitize STATUS_CHANGE messages.

[vlc] / src / libvlc.h

diff --git a/src/libvlc.h b/src/libvlc.h
index fb1e598c9a95e9154f124c6e94c7b046c44af25a..043becc52c44aafe4a3ee8b7596d6fbe20d08434 100644 (file)
--- a/src/libvlc.h
+++ b/src/libvlc.h
@@ -27,9 +27,11 @@
 
 extern const char vlc_usage[];
 
+/* Hotkey stuff */
 extern const struct hotkey libvlc_hotkeys[];
 extern const size_t libvlc_hotkeys_size;
-
+extern int vlc_key_to_action (vlc_object_t *, const char *,
+                              vlc_value_t, vlc_value_t, void *);
 
 /*
  * OS-specific initialization
@@ -71,7 +73,21 @@ uint32_t CPUCapabilities( void );
  * LibVLC objects stuff
  */
 
-extern vlc_object_t *
+/**
+ * Creates a VLC object.
+ *
+ * Note that because the object name pointer must remain valid, potentially
+ * even after the destruction of the object (through the message queues), this
+ * function CANNOT be exported to plugins as is. In this case, the old
+ * vlc_object_create() must be used instead.
+ *
+ * @param p_this an existing VLC object
+ * @param i_size byte size of the object structure
+ * @param i_type object type, usually VLC_OBJECT_CUSTOM
+ * @param psz_type object type name
+ * @return the created object, or NULL.
+ */
+extern void *
 vlc_custom_create (vlc_object_t *p_this, size_t i_size, int i_type,
                    const char *psz_type);