Stream Configuration 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 configuration object is used to specify the properties of a media stream in an ASF file. Stream configuration objects can be created for existing streams in a profile or can be created empty, ready to receive new data. Stream configuration objects cannot exist independently of a profile object. To save the contents of a stream configuration object, you must call either IWMProfile::AddStream to add a new stream or IWMProfile::ReconfigStream to save changes made to an existing stream.
To create a stream configuration object, use one of the following methods.
| Method | Description |
|---|---|
| IWMProfile::CreateNewStream | Creates a stream configuration object without any data. |
| IWMProfile::GetStream | Creates a stream configuration object populated with data from a profile. Uses the stream index to identify the desired stream. |
| IWMProfile::GetStreamByNumber | Creates a stream configuration object populated with data from a profile. Uses the stream number to identify the desired stream. |
All of the methods in the preceding table set a pointer to an IWMStreamConfig interface. The other interfaces of the stream configuration object can be obtained by calling the QueryInterface method.
The following interfaces are supported by the stream configuration object.
| Interface | Description |
|---|---|
| IWMMediaProps | Sets and retrieves the WM_MEDIA_TYPE structure for the stream. |
| IWMPropertyVault | Sets and retrieves properties that are not required for all streams, like variable bit rate (VBR) settings. |
| IWMStreamConfig | Sets and retrieves all of the basic information about a stream. |
| IWMStreamConfig2 | Configures the types of data unit extensions associated with the stream. Inherits all of the methods of IWMStreamConfig. |
| IWMStreamConfig3 | Sets and retrieves the language for the stream. Inherits all of the methods of IWMStreamConfig and IWMStreamConfig2. |
| IWMVideoMediaProps | Manages the properties of a video stream. This is an optional interface, and is available only for video streams. |
Related topics