to_running_time_full
Description:
[ Version ( since = "1.6" ) ]
public int to_running_time_full (Format format, uint64 position, out uint64 running_time)
public int to_running_time_full (Format format, uint64 position, out uint64 running_time)
Translate position to the total running time using the currently configured segment.
Compared to to_running_time this function can return negative running-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 running-time returned in running_time.
When this function returns -1, the returned running_time should be negated to get the real negative running time.
Parameters:
| this |
a Segment structure. |
| format |
the format of the segment. |
| position |
the position in the segment |
| running_time |
result running-time |
Returns:
|
a 1 or -1 on success, 0 on failure. |