From: Rémi Denis-Courmont <rem@videolan.org>
Date: Tue, 25 Mar 2008 21:08:20 +0000 (+0200)
Subject: Document vlc_custom_create.
X-Git-Tag: 0.9.0-test0~1886
X-Git-Url: https://git.sesse.net/?a=commitdiff_plain;h=7b7d2516fcb4a501a923557ca1f9ffb5f1c77ccd;p=vlc

Document vlc_custom_create.
---

diff --git a/src/libvlc.h b/src/libvlc.h
index fb1e598c9a..046f0f4f82 100644
--- a/src/libvlc.h
+++ b/src/libvlc.h
@@ -71,6 +71,20 @@ uint32_t CPUCapabilities( void );
  * LibVLC objects stuff
  */
 
+/**
+ * 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 vlc_object_t *
 vlc_custom_create (vlc_object_t *p_this, size_t i_size, int i_type,
                    const char *psz_type);