AppSink.tryPullPreroll

Get the last preroll sample in @appsink. This was the sample that caused the appsink to preroll in the PAUSED state.

This function is typically used when dealing with a pipeline in the PAUSED state. Calling this function after doing a seek will give the sample right after the seek position.

Calling this function will clear the internal reference to the preroll buffer.

Note that the preroll sample will also be returned as the first sample when calling gst_app_sink_pull_sample().

If an EOS event was received before any buffers or the timeout expires, this function returns %NULL. Use gst_app_sink_is_eos () to check for the EOS condition.

This function blocks until a preroll sample or EOS is received, the appsink element is set to the READY/NULL state, or the timeout expires.

class AppSink
tryPullPreroll

Parameters

timeout GstClockTime

the maximum amount of time to wait for the preroll sample

Return Value

Type: Sample

a #GstSample or NULL when the appsink is stopped or EOS or the timeout expires. Call gst_sample_unref() after usage.

Meta

Since

1.10