IDvdInfo2::GetAudioLanguage

 
Microsoft DirectShow 9.0

IDvdInfo2::GetAudioLanguage

The GetAudioLanguage method retrieves the language of the specified audio stream within the current title.

Syntax

  HRESULT GetAudioLanguage(
  ULONG ulStream,
  LCID *pLanguage
);

Parameters

ulStream

[in] Audio stream number for the language being retrieved.

pLanguage

[out] Pointer to an LCID that receives the language information.

Return Values

Returns one of the following HRESULT values.

Return code Description
S_OK Success.
E_INVALIDARG Invalid argument.
E_POINTER The pLanguage parameter is NULL.
E_UNEXPECTED The DVD Navigator is not initialized.
VFW_E_DVD_INVALIDDOMAIN DVD Navigator is not in a valid domain.

Remarks

This method does not return languages for menus. It sets the value pointed to by pLanguage to zero if the stream contains an unknown language. Call the GetLocaleInfo function to create a human-readable string name from pLanguage:

LCID Language;
hr = pDvdInfo->GetAudioLanguage(ulStream, &Language);
if (SUCCEEDED(hr))
{
    int cchSize = GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, 0, 0);
    TCHAR *szString = new TCHAR[cchSize];
    if (szString)
    {
        GetLocaleInfo(Language, LOCALE_SENGLANGUAGE, szString, cchSize);
        /* ... */
        delete [] szString;
    }
}

Requirements

Header: Declared in Strmif.h; include Dshow.h.

Library: Use Strmiids.lib.

See Also