IWMStreamPrioritization interface (wmsdkidl.h)
[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.]
The IWMStreamPrioritization interface provides methods to set and read priority records for a file.
Stream prioritization allows content creators to specify the priority of the streams in an ASF file. The streams assigned the lowest priority will be dropped first in the case of insufficient bit rate during playback.
Only one stream prioritization object can exist for a profile. You can check to see if one is present with a call to IWMProfile3::GetStreamPrioritization, which will retrieve a pointer to one if it exists.
You can create a new stream prioritization object with a call to IWMProfile3::CreateNewStreamPrioritization. You will then receive a pointer to IWMStreamPrioritization for the new object. This will erase the existing stream prioritization, if there is one.
Inheritance
The IWMStreamPrioritization interface inherits from the IUnknown interface. IWMStreamPrioritization also has these types of members:
Methods
The IWMStreamPrioritization interface has these methods.
| IWMStreamPrioritization::GetPriorityRecords The GetPriorityRecords method retrieves the list of streams and their priorities from the profile. |
| IWMStreamPrioritization::SetPriorityRecords The SetPriorityRecords method assigns the members of an array as the stream priority list in the stream prioritization object. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | wmsdkidl.h |