]> code.delx.au - pulseaudio/blobdiff - PROTOCOL
Notify port available status changes, and update protocol version
[pulseaudio] / PROTOCOL
index 03a9cb5cfe56050729f8c63508c90fb86bf6f886..7468cd47619ec54b2d15007fa9ebd9b27343fb16 100644 (file)
--- a/PROTOCOL
+++ b/PROTOCOL
@@ -262,3 +262,39 @@ PA_COMMAND_GET_SOURCE_INFO_LIST)
     format_info format1
     ...
     format_info formatn
+
+Five new fields in reply from PA_COMMAND_GET_SOURCE_OUTPUT_INFO (and thus
+PA_COMMAND_GET_SOURCE_OUTPUT_INFO_LIST)
+
+    format_info format
+    volume
+    bool mute
+    bool has_volume
+    bool volume_writable
+
+## v23, implemented by >= 1.0
+
+New field in PA_COMMAND_UNDERFLOW:
+
+    int64_t index
+
+## v24, implemented by >= 2.0
+
+New field in all commands that send/receive port introspection data
+(PA_COMMAND_GET_(SOURCE|SINK)_OUTPUT_INFO,
+PA_COMMAND_GET_(SOURCE|SINK)_OUTPUT_INFO_LIST):
+
+    uint32_t available
+
+The field is added once for every port.
+
+## v25, implemented by >= 2.0
+
+When port availability changes, send a subscription event for the
+owning card.
+
+#### If you just changed the protocol, read this
+## module-tunnel depends on the sink/source/sink-input/source-input protocol
+## internals, so if you changed these, you might have broken module-tunnel.
+## Don't forget to test module-tunnel-{source,sink} when pushing protocol
+## changes.