IltmmMultiStreamTarget::GetConnectedMediaType

#include "ltmm.h"

C Syntax

HRESULT IltmmMultiStreamTarget_GetConnectedMediaType(pMultiStreamTarget, Stream, ppMediaType);

C++ Syntax

HRESULT GetConnectedMediaType(Stream, ppMediaType);

 

IltmmMultiStreamTarget *pMultiStreamTarget;

/* pointer to an interface */

long Stream;

/* stream index */

IltmmMediaTypeDisp ** ppMediaType;

/* pointer to a variable */

Retrieves the actually connected media type of the stream.

Parameter

Description

pMultiStreamTarget

Pointer to an IltmmMultiStreamTarget interface.

Stream

The stream index (0-based) for which to retrieve the actually connected media type.

ppMediaType

Pointer to a variable that will receive a pointer to an IltmmMediaTypeDisp interface that describes the connected media type of the stream at the specified index.

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

If the function succeeds, the caller must free the returned interface by calling its Release() function.

This function returns the actually connected media type of the stream and might be different from the media type returned by IltmmMultiStreamTarget::GetAcceptedMediaType.

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:

IltmmMultiStreamTarget::get_StreamCount, IltmmMultiStreamTarget::put_StreamCount, IltmmMultiStreamTarget::SetAcceptedMediaType, IltmmMultiStreamTarget::GetAcceptedMediaType, IltmmMultiStreamTarget::GetSample, IltmmMultiStreamTarget::WaitForSample

Topics:

Multimedia Function Group

Example

For a C example, refer to Concatenate two AVI files using IltmmMultiStreamSource and IltmmMultiStreamTarget Example for C.

For a C example, refer to Replace Audio using IltmmMultiStreamSource and IltmmMultiStreamTarget Example for C.

For a C++ example, refer to Concatenate two AVI files using IltmmMultiStreamSource and IltmmMultiStreamTarget Example for C++.

For a C++ example, refer to Replace Audio using IltmmMultiStreamSource and IltmmMultiStreamTarget Example for C++.