IltmmPlay::get_ProgramCount

#include "ltmm.h"

C Syntax	HRESULT IltmmPlay_get_ProgramCount(pPlay, pVal)
C++ Syntax	HRESULT get_ProgramCount(pVal)

IltmmPlay *pPlay;	pointer to an interface
long *pVal;	pointer to a variable

Gets the number of programs in the current file.

Parameter	Description
pPlay	Pointer to an IltmmPlay interface.
pVal	Pointer to a variable to be updated with the number of prgrams. In most cases, this value will be filled with 1.

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. Change the current program by calling IltmmPlay::put_CurrentProgram.

Get the number of streams in the current program by calling IltmmPlay::get_StreamCount.

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 program of a multi-program file. There is no error checking to make the example easier to understand */

/* This example will select the last program of a multi-program file. There is no error checking to make the example easier to understand */ 
void SelectLastProgram(IltmmPlay *pPlay) 
{ 
   long ProgramCount = 0; 
   pPlay->get_ProgramCount(&ProgramCount); 
   if(ProgramCount > 1) 
   { 
      /* If there is more than one program, select the last program. If there is only one program, you are already on the last program. The program index is 0-based, so the allowed value to pass to IltmmPlay::put_CurrentProgram is between 0 and ProgramCount - 1 */ 
      pPlay->put_CurrentProgram(ProgramCount - 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::get_StreamCount, IltmmPlay::put_CurrentProgram
Topics:	Multimedia Function Groups
	Programs and Streams
	Closed Captioning