position_from_running_time_full
Description:
public int position_from_running_time_full (Format format, uint64 running_time, out uint64 position)
Translate running_time to the segment position using the currently configured segment.
Compared to position_from_running_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.
running_time can be any value and the result of this function for values outside of the segment is extrapolated.
When 1 is returned, running_time resulted in a positive position returned in position.
When this function returns -1, the returned position was < 0, and the value in the position variable should be negated to get
the real negative segment position.
Parameters:
| this |
a Segment structure. |
| format |
the format of the segment. |
| running_time |
the running-time |
| position |
the resulting position in the segment |
Returns:
|
a 1 or -1 on success, 0 on failure. |