mirrors/pipewire
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pipewire/pipewire.git synced 2025-11-03 09:01:54 -05:00
Code Issues Projects Releases Packages Wiki Activity Actions

protocol-native: extend v3 protocol with message footers

Browse source 
Extend version 3 protocol with message footers, which are for passing
around global state data that is not addressed to a specific object.

The extension is backward compatible with previous v3 clients, and won't
e.g. result to error spam in logs.

The footer is a single SPA POD, appended after the main message POD.
Because both the protocol message and the message POD record their
length, it's possible to append trailing data. Earlier clients will
ignore any data trailing the message POD.

The footer POD contains a sequence [Id opcode, Struct {...}]*,
so there is room to extend with new opcodes later as necessary.

There are separate marshal/demarshal routines for messages aimed at
resources and proxies.
This commit is contained in:
Pauli Virtanen 2022-02-20 14:03:41 +02:00
parent c4997fc46d
commit 680c33d3eb
7 changed files with 253 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

3
src/modules/module-protocol-native/connection.h
View file

@ -102,6 +102,9 @@ pw_protocol_native_connection_clear(struct pw_protocol_native_connection *conn);
void pw_protocol_native_connection_enter(struct pw_protocol_native_connection *conn);
void pw_protocol_native_connection_leave(struct pw_protocol_native_connection *conn);
struct spa_pod *pw_protocol_native_connection_get_footer(struct pw_protocol_native_connection *conn,
const struct pw_protocol_native_message *msg);
#ifdef __cplusplus
} /* extern "C" */
#endif