IltmmPlay::get_StreamCount

#include "ltmm.h"

C Syntax

HRESULT IltmmPlay_get_StreamCount(pPlay, streamType, pVal)

C++ Syntax

HRESULT get_StreamCount(streamType, pVal)

IltmmPlay *pPlay;

pointer to an interface

ltmmPlay_Stream streamType;

the stream type

long *pVal;

pointer to a variable

Gets the number of streams of the specified stream type in the current program.

Parameter Description
pPlay Pointer to an IltmmPlay interface.
streamType The type of stream you're interested in. Currently, only two stream types are supported: Video (ltmmPlay_Stream_Video) and Audio (ltmmPlay_Stream_Audio).
pVal Pointer to a variable to be updated with the number of streams of the specified streamType.

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

See the Programs and Streams topic for more information on programs and streams.

This property returns the number of streams of the specified type in the current program. You can then select which streams to play by calling IltmmPlay::put_SelectedStream.

If you change the current program using IltmmPlay::put_CurrentProgram, the number of streams can change. So you will need to call IltmmPlay::get_StreamCount again.

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:

IltmmPlay::put_SelectedStream, IltmmPlay::get_SelectedStream, IltmmPlay::get_StreamCount, IltmmPlay::get_ProgramCount, IltmmPlay::put_CurrentProgram, IltmmPlay::get_CurrentProgram

Topics:

Multimedia Function Groups

 

Programs and Streams

Closed Captioning

Example

C++ example:

/* This example will select the last video and audio streams. There is no error checking to make the example easier to understand */ void SelectLastProgram(IltmmPlay *pPlay) 
{ 
   long StreamCount = 0; 
   /* Select the last video stream - rarely necessary, since there is usually only one video stream */ 
   pPlay->get_StreamCount(ltmmPlay_Stream_Video, &StreamCount); 
   if(StreamCount > 1) 
      pPlay->put_SelectedStream(ltmmPlay_Stream_Video, StreamCount - 1); 
   /* Select the last audio stream */ 
   pPlay->get_StreamCount(ltmmPlay_Stream_Audio, &StreamCount); 
   if(StreamCount > 1) 
      pPlay->put_SelectedStream(ltmmPlay_Stream_Audio, StreamCount - 1); 
} 

Help Version 20.0.2020.4.2
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2020 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help