IDvdInfo2::GetDVDTextLanguageInfo

  • Article
 
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