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