IltmmDVDControl::GetDVDTextNumberOfStrings

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl__getDVDTextNumberOfStrings(pDVD, Index, pStrings)

C++ Syntax

HRESULT GetDVDTextNumberOfStrings(Index, pStrings)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long Index;

/* index */

long *pStrings;

/* pointer to a variable */

Retrieves the number of strings for the specified language block.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

Index

Language block from which to retrieve the number of strings.

pStrings

Pointer to a variable updated with the total number of strings in the language block.

Returns

S_OK

The function ran successfully.

<> S_OK

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

Comments

Before calling this function, determine the total number of language blocks available by calling IltmmDVDControl::get_DVDTextNumberOfLanguages. Based on the value obtained from IltmmDVDControl::get_DVDTextNumberOfLanguages, pass an appropriate index value for the Index parameter of this function, to retrieve the number of strings for the desired language block. For example, if the IltmmDVDControl::get_DVDTextNumberOfLanguages retrieves the value 4, then possible values for the Index parameter of this function is 0 – 3.

For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetDVDTextLanguageInfo at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdinfo2getdvdtextlanguageinfo.asp.

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.

See Also

Elements:

IltmmDVDControl interface, IltmmDVDControl::GetDVDTextLanguageLCID, IltmmDVDControl::get_DVDTextNumberOfLanguages, IltmmDVDControl::GetDVDTextString, IltmmDVDControl::GetDVDTextStringType

Topics:

Multimedia Function Group

Example

For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.

For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.