In This Topic ▼

IltmmDVDControl::GetDVDTextNumberOfStrings

Summary

Retrieves the number of strings for the specified language block.

Syntax

#include "ltmm.h"

Language	Syntax
C	HRESULT IltmmDVDControl_getDVDTextNumberOfStrings(pDVD, index, pVal)
C++	HRESULT GetDVDTextNumberOfStrings(index, pVal)

Parameters

IltmmDVDControl *pDVD

Pointer to an IltmmDVDControl interface.

long index

Language block from which to retrieve the number of strings.

long *pVal

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

Returns

Value	Meaning
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.