aboutsummaryrefslogtreecommitdiffstats
path: root/ext/resize-port.lv2/resize-port.h
diff options
context:
space:
mode:
Diffstat (limited to 'ext/resize-port.lv2/resize-port.h')
-rw-r--r--ext/resize-port.lv2/resize-port.h10
1 files changed, 10 insertions, 0 deletions
diff --git a/ext/resize-port.lv2/resize-port.h b/ext/resize-port.lv2/resize-port.h
index 4ba533b..ad6a5dc 100644
--- a/ext/resize-port.lv2/resize-port.h
+++ b/ext/resize-port.lv2/resize-port.h
@@ -35,6 +35,16 @@ typedef struct {
* This function MAY return false, in which case the port buffer was
* not resized and the port is still connected to the same location.
* Plugins MUST gracefully handle this situation.
+ *
+ * This function MUST NOT be called from any context other than
+ * the context associated with the port of the given index.
+ *
+ * The host MUST preserve the contents of the port buffer when
+ * resizing.
+ *
+ * Plugins MAY resize a port many times in a single run callback.
+ * Hosts SHOULD make this an inexpensive as possible (i.e. plugins
+ * can liberally use this function in a similar way to realloc).
*/
bool (*resize_port)(LV2_Resize_Port_Feature_Data data,
uint32_t index,