IltmmWMProfile::AddStream

#include "ltmm.h"

C Syntax

HRESULT IltmmWMProfile_AddStream(pProfile, Config)

C++ Syntax

HRESULT AddStream(Config)

 

IltmmWMProfile *pProfile;

/* pointer to an interface */

IltmmWMStreamConfig *Config;

/* pointer to an interface */

Adds a stream to the profile.

Parameter

Description

pProfile

Pointer to an IltmmWMProfile interface.

Config

Pointer to an IltmmWMStreamConfig interface. This interface references information about the stream to add.

Returns

S_OK

The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.

Comments

This function works by copying the specified stream configuration information into the profile.

New streams are created using IltmmWMProfile::CreateNewStream. Configure the newly created stream using the IltmmWMStreamConfig interface before adding it to the profile using IltmmWMProfile::AddStream. A maximum of 63 streams can be added to a profile.

For more information, refer to the Microsoft documentation for IWMProfile::AddStream.

To add a script command stream to the file, use IltmmWMScript::put_EnableScriptStream.

Required DLLs and Libraries

LTMM

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Win32, x64

See Also

Elements:

IltmmWMProfile::GetStreamByNumber, IltmmWMProfile::RemoveStream, IltmmWMProfile::GetStream; IltmmWMProfile::get_StreamCount, IltmmWMProfile::RemoveStreamByNumber, IltmmWMProfile::ReconfigStream, IltmmWMProfile::CreateNewStream, IltmmWMScript Interface, IltmmWMScript::put_EnableScriptStream

Topics:

Windows Media Support

 

Multimedia Function Groups

 

Adding Script Commands to Windows Media Video

Example

For a C example, refer to IltmmWMProfile::AddStream Example for C.

For a C++ example, refer to IltmmWMProfile::AddStream Example for C++.