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.

See Also

Elements:	IltmmMultiStreamTarget::get_StreamCount, IltmmMultiStreamTarget::put_StreamCount, IltmmMultiStreamTarget::SetAcceptedMediaType, IltmmMultiStreamTarget::GetConnectedMediaType, IltmmMultiStreamTarget::GetSample, IltmmMultiStreamTarget::WaitForSample
Topics:	Multimedia Function Group

Example