IDvdInfo::GetSubpictureLanguage method (strmif.h)

  • Article

[The feature associated with this page, DirectShow, is a legacy feature. It has been superseded by MediaPlayer, IMFMediaEngine, and Audio/Video Capture in Media Foundation. Those features have been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer, IMFMediaEngine and Audio/Video Capture in Media Foundation instead of DirectShow, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

Note  The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.
 
Retrieves the language of the specified subpicture stream within the current title.

Syntax

HRESULT GetSubpictureLanguage(
  [in]  ULONG ulStream,
  [out] LCID  *pLanguage
);

Parameters

[in] ulStream

Stream number.

[out] pLanguage

Pointer to the retrieved language.

Return value

Returns an HRESULT value .

Return code Description
E_UNEXPECTED
 DVD is not initialized or domain is not DVD_DOMAIN_Title.
S_OK
 Success.
VFW_E_DVD_INVALIDDOMAIN
 Requested action is not supported on this domain (DVD_DOMAIN).
VFW_E_DVD_OPERATION_INHIBITED
 Requested action cannot occur at this point in the movie due to the authoring of the current DVD-Video disc.

Remarks

This method returns an error unless the domain is DVD_DOMAIN_Title. For more information, see DVD_DOMAIN.

This method does not return languages for menus. This method sets the value pointed to by pLanguage to zero if the stream does not include language. Call the Win32 GetLocaleInfo function as follows to create a human-readable string name from pLanguage. LOCALE_SENGLANGUAGE is the locale information type, pszString is a pointer to a buffer to receive the requested data, and cbSize specifies the size of pszString.

C++ 
GetLocaleInfo(*pLanguage, LOCALE_SENGLANGUAGE, pszString, cbSize);

Requirements

Requirement Value
Target Platform Windows
Header strmif.h (include Dshow.h)

See also

Error and Success Codes

IDvdInfo Interface