IltmmDVDControl::GetDVDTextStringType
#include "ltmm.h"
C Syntax |
HRESULT IltmmDVDControl__getDVDTextStringType(pDVD, LangIndex, StringIndex, pType) |
C++ Syntax |
HRESULT GetDVDTextStringType(LangIndex, StringIndex, pType) |
IltmmDVDControl *pDVD; |
/* pointer to an interface */ |
long LangIndex; |
/* index */ |
long StringIndex; |
/* index */ |
long *pType; |
/* pointer to a variable */ |
Retrieves the text string type for the specified language and string indexes.
Parameter |
Description |
pDVD |
Pointer to an IltmmDVDControl interface. |
LangIndex |
Language block from which to retrieve the text string type. |
StringIndex |
String index of the specified language block from which to retrieve the text string type. |
pType |
Pointer to a variable that receives one of the ltmmDVD_TextStringType constants. |
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 type of the specified string.
For more detailed information, refer to the Microsoft documentation for IDvdInfo2::GetDVDTextStringAsUnicode at http://msdn.microsoft.com/archive/default.asp?url=/library/en-us/directshow/htm/idvdinfo2getdvdtextstringasunicode.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
Example
For a C example, refer to IltmmDVDControl::GetButtonAtPosition Example for C.
For a C++ example, refer to IltmmDVDControl::GetButtonAtPosition Example for C++.