mirrors/pulseaudio
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/pulseaudio/pulseaudio.git synced 2025-10-29 05:40:23 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

mainloop: Document need for mainloop lock around pa_mainloop_api_once

Browse source 
This needs us to expose a bit of implementation detail, but this seems
to be the cleanest way without an API change.

The specific problem is that pa_mainloop_api_once() needs to first
create a defer event and then set its destroy callback. If the defer
event is completed before the callback is set, an assert will be
trigerred.
This commit is contained in:
Arun Raghavan 2013-06-17 18:07:42 +05:30
parent b2792d7837
commit 9a0dd11342
1 changed files with 3 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/pulse/mainloop-api.h
View file

@ -114,7 +114,9 @@ struct pa_mainloop_api {
void (*quit)(pa_mainloop_api*a, int retval);
};
/** Run the specified callback function once from the main loop using an anonymous defer event. */
/** Run the specified callback function once from the main loop using an anonymous defer event. Note that this performs
* multiple mainloop operations non-atomically. If, for example, you are using a \pa_threaded_mainloop, you will need to
* take the mainloop lock before this call. */
void pa_mainloop_api_once(pa_mainloop_api*m, void (*callback)(pa_mainloop_api*m, void *userdata), void *userdata);
PA_C_DECL_END