Bug 1641161 - Bug 1285290 Document suspend/resume accounting wrt ApplyAudioContextOperation() r=padenot

Depends on D76803

Differential Revision: https://phabricator.services.mozilla.com/D76804
This commit is contained in:
Karl Tomlinson 2020-05-27 08:39:48 +00:00
parent 5e4f415213
commit dd53506c39

View File

@ -1083,10 +1083,16 @@ class MediaTrackGraph {
* will be resolved later than the promise of the method above.*/
RefPtr<GraphStartedPromise> NotifyWhenDeviceStarted(MediaTrack* aTrack);
/* From the main thread, suspend, resume or close an AudioContext.
/* From the main thread, suspend, resume or close an AudioContext. Calls
* are not counted. Even Resume calls can be more frequent than Suspend
* calls.
*
* aTracks are the tracks of all the AudioNodes of the AudioContext that
* need to be suspended or resumed. This can be empty if this is a second
* consecutive suspend call and all the nodes are already suspended.
* need to be suspended or resumed. Suspend and Resume operations on these
* tracks are counted. Resume operations must not outnumber Suspends and a
* track will not resume until the number of Resume operations matches the
* number of Suspends. This array may be empty if, for example, this is a
* second consecutive suspend call and all the nodes are already suspended.
*
* This can possibly pause the graph thread, releasing system resources, if
* all tracks have been suspended/closed.