IltmmWMProfile::GetStream

#include "ltmm.h"

C Syntax

HRESULT IltmmWMProfile__getStream(pProfile, StreamIndex, pVal)

C++ Syntax

HRESULT GetStream(StreamIndex, pVal)

 

IltmmWMProfile *pProfile;

/* pointer to an interface */

long StreamIndex;

/* index */

IltmmWMStreamConfig **pVal;

/* pointer to a pointer */

Gets an interface to the stream at the specified index in the profile.

Parameter

Description

pProfile

Pointer to an IltmmWMProfile interface.

StreamIndex

Index of the stream to retrieve. This is a zero-based index.

pVal

Pointer to a variable to be updated with a pointer to an IltmmWMStreamConfig interface. This interface will reference the retrieved stream.

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

To get the number of streams in the profile, use IltmmWMProfile::get_StreamCount.

The user is responsible for releasing the retrieved interface by calling its Release() function, when it is no longer needed.

For more information, refer to the Microsoft documentation for IWMProfile::GetStream at http://msdn.microsoft.com/library/default.asp?url=/library/en-us/wmform11/htm/iwmprofilegetstream.asp.

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.

See Also

Elements:

IltmmWMProfile::get_StreamCount, IltmmWMProfile::GetStreamByNumber, IltmmWMProfile::AddStream, IltmmWMProfile::RemoveStream, IltmmWMProfile::RemoveStreamByNumber, IltmmWMProfile::ReconfigStream, IltmmWMProfile::CreateNewStream

Topics:

Windows Media Support

 

Multimedia Function Group

Example

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

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