Collapse All Expand All

IltmmDVDControl::GetDVDTextString

#include "ltmm.h"

C Syntax	HRESULT IltmmDVDControl_getDVDTextString(pDVD, LangIndex, StringIndex, pString)
C++ Syntax	HRESULT GetDVDTextString(LangIndex, StringIndex, pString)

 

IltmmDVDControl *pDVD;	/* pointer to an interface */
long LangIndex;	/* index */
long StringIndex;	/* index */
BSTR *pString;	/* pointer to a string */

Retrieves the text string for the specified language and string indexes in Unicode.

Parameter	Description
pDVD	Pointer to an IltmmDVDControl interface.
LangIndex	Language block from which to retrieve the text string.
StringIndex	String index of the specified language block from which to retrieve the text string.
pString	Pointer to a variable that receives the text string.

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 the IltmmDVDControl::GetDVDTextNumberOfStrings function, to retrieve the number of strings in the specified language block. Then, pass an appropriate language index value and string index value to this function to retrieve the desired string.

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

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