to_stream_time_full
Description:
[ Version ( since = "1.8" ) ]
public int to_stream_time_full (Format format, uint64 position, out uint64 stream_time)
public int to_stream_time_full (Format format, uint64 position, out uint64 stream_time)
Translate position to the total stream time using the currently configured segment.
Compared to to_stream_time this function can return negative stream-time.
This function is typically used by elements that need to synchronize buffers against the clock or each other.
position can be any value and the result of this function for values outside of the segment is extrapolated.
When 1 is returned, position resulted in a positive stream-time returned in stream_time.
When this function returns -1, the returned stream_time should be negated to get the real negative stream time.
Parameters:
| this |
a Segment structure. |
| format |
the format of the segment. |
| position |
the position in the segment |
| stream_time |
result stream-time |
Returns:
|
a 1 or -1 on success, 0 on failure. |