Stream Prioritization Object

[The feature associated with this page, Windows Media Format 11 SDK, is a legacy feature. It has been superseded by Source Reader and Sink Writer. Source Reader and Sink Writer have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use Source Reader and Sink Writer instead of Windows Media Format 11 SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

A stream prioritization object is used to specify an order of importance for the streams in a profile. When full playback is not possible due to bit-rate limitations, the lowest priority streams will be the first to be dropped.

Stream prioritization objects can be created for existing stream prioritization data in a profile or can be created empty, ready to receive new data. Stream prioritization objects cannot exist independently of a profile object. To save the contents of a stream prioritization object, you must call IWMProfile3::SetStreamPrioritization. To create a stream prioritization object, use one of the following methods.

Method	Description
IWMProfile3::CreateNewStreamPrioritization	Creates a stream prioritization object without any data.
IWMProfile3::GetStreamPrioritization	Creates a stream prioritization object populated with data from the profile.

 

Both methods in the preceding table set a pointer to an IWMStreamPrioritization interface. This is the only interface supported by the stream prioritization object.

Interface	Description
IWMStreamPrioritization	Manages the list of streams within the stream prioritization object.

 

Remarks

Only one stream prioritization can exist for a given profile. If you create a new stream prioritization for a profile that already contains a stream prioritization, the old one will be deleted.

Related topics

Objects

Profile Object

Using Stream Prioritization