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

See Also

Elements:

IltmmPlay::get_StreamCount, IltmmPlay::put_CurrentProgram

Topics:

Multimedia Function Groups

 

Programs and Streams

Closed Captioning

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

LEADTOOLS Multimedia C API Help