IltmmConvert::get_SourceProgramCount

#include "ltmm.h"

C Syntax	HRESULT IltmmConvert_get_SourceProgramCount(pConvert, pVal)
C++ Syntax	HRESULT get_SourceProgramCount(pVal)

IltmmConvert *pConvert;	pointer to an interface
long *pVal;	pointer to a variable

Get the number of programs in the current file.

Parameter	Description
pConvert	Pointer to an IltmmConvert interface.
pVal	Pointer to a variable to be updated with the number of programs. 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. You can change the current program using IltmmConvert::put_CurrentSourceProgram.

You can get the number of streams in the current program by calling IltmmConvert::get_SourceStreamCount.

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 */ 
void SelectLastProgram(IltmmConvert *pConvert) 
{ 
   long SourceProgramCount = 0; 
   pConvert->get_SourceProgramCount(&SourceProgramCount); 
   if(SourceProgramCount > 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 IltmmConvert::put_CurrentSourceProgram is between 0 and SourceProgramCount - 1 */ 
      pConvert->put_CurrentSourceProgram(SourceProgramCount - 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:	IltmmConvert::put_CurrentSourceProgram, IltmmConvert::get_CurrentSourceProgram, IltmmConvert::get_SourceStreamCount
Topics:	Multimedia Function Groups
	Closed Captioning, Programs and Streams