#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.



The function was successful.

<> S_OK

An error occurred. Refer to the Error Codes or the HRESULT error codes in the DirectShow documentation.


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


For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.


Win32, x64

See Also


IltmmConvert::put_CurrentSourceProgram, IltmmConvert::get_CurrentSourceProgram, IltmmConvert::get_SourceStreamCount


Multimedia Function Groups


Closed Captioning, Programs and Streams


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; 
   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 21.0.2021.4.7
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Multimedia C API Help