wait_preroll

If the GstBaseSinkClass::render method performs its own synchronisation against the clock it must unblock when going from PLAYING to the PAUSED state and call this method before continuing to render the remaining data.

If the GstBaseSinkClass::render method can block on something else than the clock, it must also be ready to unblock immediately on the GstBaseSinkClass::unlock method and cause the GstBaseSinkClass::render method to immediately call this function. In this case, the subclass must be prepared to continue rendering where it left off if this function returns OK.

This function will block until a state change to PLAYING happens (in which case this function returns OK) or the processing must be stopped due to a state change to READY or a FLUSH event (in which case this function returns FLUSHING).

This function should only be called with the PREROLL_LOCK held, like in the render function.

Parameters:

this

the sink

Returns:

OK if the preroll completed and processing can continue. Any other return value should be returned from the render vmethod.