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

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 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help

Multimedia Files You Must Include With Your Application (Redistributables)

Frequently Asked Questions

LEADTOOLS Multimedia Features

Add-on Modules

Programming with LEADTOOLS Multimedia

Appendix

LEADTOOLS Licensing

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