mirrors/pulseaudio
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git synced 2025-10-31 22:25:33 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

thread-mainloop: Extend the locking documentation a bit

Browse source 
Make it more clear which objects require locking. I remember talking to
multiple people for whom that wasn't immediately clear from the
documentation.
This commit is contained in:
Tanu Kaskinen 2020-05-27 09:41:40 +03:00
parent 36a4923f9b
commit 3dc525df5d
1 changed files with 5 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

8
src/pulse/thread-mainloop.h
View file

@ -66,9 +66,11 @@ PA_C_DECL_BEGIN
* number of times you called pa_threaded_mainloop_lock().
*
* The lock needs to be held whenever you call any PulseAudio function that
* uses an object associated with this main loop. Make sure you do not hold
* on to the lock more than necessary though, as the threaded main loop stops
* while the lock is held.
* uses an object associated with this main loop. Those objects include
* pa_mainloop, pa_context, pa_stream and pa_operation, and the various event
* objects (pa_io_event, pa_time_event, pa_defer_event). Make sure you do not
* hold on to the lock more than necessary though, as the threaded main loop
* stops while the lock is held.
*
* Example:
*