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

See Also

Elements:

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

Topics:

Multimedia Function Groups

 

Closed Captioning, Programs and Streams

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

LEADTOOLS Multimedia C API Help