Pad.createStreamId

Creates a stream-id for the source #GstPad @pad by combining the upstream information with the optional @stream_id of the stream of @pad. @pad must have a parent #GstElement and which must have zero or one sinkpad. @stream_id can only be %NULL if the parent element of @pad has only a single source pad.

This function generates an unique stream-id by getting the upstream stream-start event stream ID and appending @stream_id 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.

class Pad
string
createStreamId

Parameters

parent Element

Parent #GstElement of @pad

streamId string

The stream-id

Return Value

Type: string

A stream-id for @pad. g_free() after usage.

Meta