position_from_stream_time_full


Description:

[ Version ( since = "1.8" ) ]
public int position_from_stream_time_full (Format format, uint64 stream_time, out uint64 position)

Translate stream_time to the segment position using the currently configured segment.

Compared to position_from_stream_time this function can return negative segment position.

This function is typically used by elements that need to synchronize buffers against the clock or each other.

stream_time can be any value and the result of this function for values outside of the segment is extrapolated.

When 1 is returned, stream_time resulted in a positive position returned in position.

When this function returns -1, the returned position should be negated to get the real negative segment position.

Parameters:

this

a Segment structure.

format

the format of the segment.

stream_time

the stream-time

position

the resulting position in the segment

Returns:

a 1 or -1 on success, 0 on failure.