PipeWire  0.3.33
pw_core_methods Struct Reference

Core methods. More...

Data Fields

uint32_t version
 
int(* add_listener )(void *object, struct spa_hook *listener, const struct pw_core_events *events, void *data)
 
int(* hello )(void *object, uint32_t version)
 Start a conversation with the server. More...
 
int(* sync )(void *object, uint32_t id, int seq)
 Do server roundtrip. More...
 
int(* pong )(void *object, uint32_t id, int seq)
 Reply to a server ping event. More...
 
int(* error )(void *object, uint32_t id, int seq, int res, const char *message)
 Fatal error event. More...
 
struct pw_registry *(* get_registry )(void *object, uint32_t version, size_t user_data_size)
 Get the registry object. More...
 
void *(* create_object )(void *object, const char *factory_name, const char *type, uint32_t version, const struct spa_dict *props, size_t user_data_size)
 Create a new object on the PipeWire server from a factory. More...
 
int(* destroy )(void *object, void *proxy)
 Destroy an resource. More...
 

Detailed Description

Core methods.

The core global object. This is a singleton object used for creating new objects in the remote PipeWire instance. It is also used for internal features.

Field Documentation

◆ add_listener

int(* pw_core_methods::add_listener) (void *object, struct spa_hook *listener, const struct pw_core_events *events, void *data)

◆ create_object

void*(* pw_core_methods::create_object) (void *object, const char *factory_name, const char *type, uint32_t version, const struct spa_dict *props, size_t user_data_size)

Create a new object on the PipeWire server from a factory.

Parameters
factory_namethe factory name to use
typethe interface to bind to
versionthe version of the interface
propsextra properties
user_data_sizeextra size

◆ destroy

int(* pw_core_methods::destroy) (void *object, void *proxy)

Destroy an resource.

Destroy the server resource for the given proxy.

Parameters
objthe proxy to destroy

◆ error

int(* pw_core_methods::error) (void *object, uint32_t id, int seq, int res, const char *message)

Fatal error event.

The error method is sent out when a fatal (non-recoverable) error has occurred. The id argument is the proxy object where the error occurred, most often in response to an event on that object. The message is a brief description of the error, for (debugging) convenience.

This method is usually also emitted on the resource object with id.

Parameters
idobject where the error occurred
reserror code
messageerror description

◆ get_registry

struct pw_registry*(* pw_core_methods::get_registry) (void *object, uint32_t version, size_t user_data_size)

Get the registry object.

Create a registry object that allows the client to list and bind the global objects available from the PipeWire server

Parameters
versionthe client version
user_data_sizeextra size

◆ hello

int(* pw_core_methods::hello) (void *object, uint32_t version)

Start a conversation with the server.

This will send the core info and will destroy all resources for the client (except the core and client resource).

◆ pong

int(* pw_core_methods::pong) (void *object, uint32_t id, int seq)

Reply to a server ping event.

Reply to the server ping event with the same seq.

Parameters
seqthe seq number received in the ping event

◆ sync

int(* pw_core_methods::sync) (void *object, uint32_t id, int seq)

Do server roundtrip.

Ask the server to emit the 'done' event with seq.

Since methods are handled in-order and events are delivered in-order, this can be used as a barrier to ensure all previous methods and the resulting events have been handled.

Parameters
seqthe seq number passed to the done event

◆ version

uint32_t pw_core_methods::version

The documentation for this struct was generated from the following file: