IWMProfile3 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 IWMProfile3 interface provides enhanced features for profiles. This includes the ability to create two new types of objects: bandwidth sharing objects and stream prioritization objects.
An IWMProfile3 interface is created for each profile object created. You can retrieve a pointer to an IWMProfile3 interface by calling the QueryInterface method of any other interface of the profile. You can also access IWMProfile3 from a reader or synchronous reader object by calling the QueryInterface method of an existing interface in the object. For more information, see IWMProfile Interface.
Inheritance
The IWMProfile3 interface inherits from IWMProfile2. IWMProfile3 also has these types of members:
Methods
The IWMProfile3 interface has these methods.
| IWMProfile3::AddBandwidthSharing The AddBandwidthSharing method adds an existing bandwidth sharing object to the profile. Bandwidth sharing objects are created with a call to CreateNewBandwidthSharing. You must configure the bandwidth sharing object before adding it to the profile. |
| IWMProfile3::CreateNewBandwidthSharing The CreateNewBandwidthSharing method creates a new bandwidth sharing object. |
| IWMProfile3::CreateNewStreamPrioritization The CreateNewStreamPrioritization method creates a new stream prioritization object. |
| IWMProfile3::GetBandwidthSharing The GetBandwidthSharing method retrieves a bandwidth sharing object from a profile. |
| IWMProfile3::GetBandwidthSharingCount The GetBandwidthSharingCount method retrieves the total number of bandwidth sharing objects that have been added to the profile. |
| IWMProfile3::GetExpectedPacketCount The GetExpectedPacketCount method calculates the expected packet count for the specified duration. The packet count returned is only an estimate, and it is based upon the settings of the profile at the time this call is made. |
| IWMProfile3::GetStorageFormat The GetStorageFormat method is not implemented. |
| IWMProfile3::GetStreamPrioritization The GetStreamPrioritization method retrieves the stream prioritization that exists in the profile. |
| IWMProfile3::RemoveBandwidthSharing The RemoveBandwidthSharing method removes a bandwidth sharing object from the profile. |
| IWMProfile3::RemoveStreamPrioritization The RemoveStreamPrioritization method removes the stream prioritization object from the profile. |
| IWMProfile3::SetStorageFormat The SetStorageFormat method is not implemented. |
| IWMProfile3::SetStreamPrioritization The SetStreamPrioritization method assigns a stream prioritization object to the profile. A profile can contain only one stream prioritization object at a time. |
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | wmsdkidl.h |