Microsoft DirectX 9.0

IDvdInfo::GetSubpictureLanguage

Note   The IDvdInfo interface is deprecated. Use IDvdInfo2 instead.

Retrieves the language of the specified subpicture stream within the current title.

Syntax

HRESULT GetSubpictureLanguage(
    ULONG nStream,
    LCID *pLanguage 
);

Parameters

nStream

[in] Stream number.

pLanguage

[out] 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.

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

See Also