IDvdInfo2::GetDVDTextLanguageInfo
| Microsoft DirectShow 9.0 |
IDvdInfo2::GetDVDTextLanguageInfo
The GetDVDTextLanguageInfo method retrieves information about the text strings for a specified language. The method retrieves the number of strings for that language, the locale identifier, and the character set.
Syntax
HRESULT GetDVDTextLanguageInfo( ULONG ulLangIndex, ULONG *pulNumOfStrings, LCID pLangCode, DVD_TextCharSet *pbCharacterSet );
Parameters
ulLangIndex
[in] Zero-based index of the language to query. To find the number of text-string languages on the DVD, call IDvdInfo2::GetDVDTextNumberOfLanguages.
pulNumOfStrings
[out] Receives the number of text strings for the specified language.
pLangCode
[out] Receives a locale identifier (LCID) that specifies the language in which the text is written. For example, the LCID for "en-us" is 0x0409.
pbCharacterSet
[out] Receives a member of the DVD_TextCharSet enumeration. The value specifies the character set of the text string.
Return Values
Returns one of the following HRESULT values.
| Return code | Description |
| S_OK | Success. |
| E_INVALIDARG | This DVD does not have any text strings, or the ulLangIndex parameter is out of bounds. |
| E_POINTER | NULL pointer argument. |
| E_UNEXPECTED | An unexpected internal error occurred. |
Remarks
To get a particular text string, call IDvdInfo2::GetDVDTextStringAsUnicode or IDvdInfo2::GetDVDTextStringAsNative.
Requirements
Header: Declared in Strmif.h; include Dshow.h.
Library: Use Strmiids.lib.
See Also