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)
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. |