IltmmMultiStreamTarget::GetAcceptedMediaType

#include "ltmm.h"

C Syntax

HRESULT IltmmMultiStreamTarget_GetAcceptedMediaType(pMultiStreamTarget, Stream, ppMediaType);

C++ Syntax

HRESULT GetAcceptedMediaType(Stream, ppMediaType);

 

IltmmMultiStreamTarget *pMultiStreamTarget;

/* pointer to an interface */

long Stream;

/* stream index */

IltmmMediaTypeDisp ** ppMediaType;

/* pointer to a variable */

Retrieves the media type of a stream.

Parameter

Description

pMultiStreamTarget

Pointer to an IltmmMultiStreamTarget interface.

Stream

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

ppMediaType

Pointer to a variable that will receive a pointer to an IltmmMediaTypeDisp interface that describes the accepted 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 it's Release() function.

This function returns the media type set using IltmmMultiStreamTarget::SetAcceptedMediaType and might be different from the actually connected media type returned by IltmmMultiStreamTarget::GetConnectedMediaType.

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:

IltmmMultiStreamTarget::get_StreamCount, IltmmMultiStreamTarget::put_StreamCount, IltmmMultiStreamTarget::SetAcceptedMediaType, IltmmMultiStreamTarget::GetConnectedMediaType, 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++.