IltmmDVDControl::get_DVDTextNumberOfLanguages

#include "ltmm.h"

C Syntax

HRESULT IltmmDVDControl_get_DVDTextNumberOfLanguages(pDVD, pLanguages)

C++ Syntax

HRESULT get_DVDTextNumberOfLanguages(pLanguages)

 

IltmmDVDControl *pDVD;

/* pointer to an interface */

long *pLanguages;

/* pointer to a variable */

Retrieves the number of text languages for the current DVD or disc side.

Parameter

Description

pDVD

Pointer to an IltmmDVDControl interface.

pLanguages

Pointer to a variable that receives the number of text languages.

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

The value referenced by pLanguages represents the number of text languages / language blocks for the current DVD or disc side. This value determines the possible values for the Index parameters of the following functions:

IltmmDVDControl::GetDVDTextLanguageLCID

IltmmDVDControl::GetDVDTextNumberOfStrings

IltmmDVDControl::GetDVDTextString

IltmmDVDControl::GetDVDTextStringType

For example, if pLanguages is updated with the value 4, there are four text languages / language blocks. Since the Index parameter of the functions listed above is zero-based, the possible values for the Index parameter is 0 © 3.

For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetDVDTextNumberOfLanguages.

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:

IltmmDVDControl interface, IltmmDVDControl::GetDVDTextLanguageLCID, IltmmDVDControl::GetDVDTextNumberOfStrings, 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++.