decorate_stream_id_printf_valist


Description:

[ Version ( since = "1.24" ) ]
public string decorate_stream_id_printf_valist (string format, va_list var_args)

Creates a stream-id for this by combining the upstream information with the format.

This function generates an unique stream-id by getting the upstream stream-start event stream ID and appending format to it. If the element has no sinkpad it will generate an upstream stream-id by doing an URI query on the element and in the worst case just uses a random number. Source elements that don't implement the URI handler interface should ideally generate a unique, deterministic stream-id manually instead.

Since stream IDs are sorted alphabetically, any numbers in the stream ID should be printed with a fixed number of characters, preceded by 0's, such as by using the format \%03u instead of \%u.

Parameters:

this

The Element to create a stream-id for

format

The stream-id

var_args

parameters for the format string

Returns:

A stream-id for this.