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

See also

Bandwidth Sharing Object

IWMBandwidthSharing Interface

IWMProfile Interface

IWMProfile2 Interface

IWMStreamPrioritization Interface

Interfaces

Stream Prioritization Object