IDvdInfo2::GetAudioLanguage method

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

Syntax

C++
Copy 

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

Parameters

ulStream [in]

Audio stream number for the language being retrieved.

pLanguage [out]

Receives the language information.

Return value

Returns one of the following HRESULT values.

Return codeDescription
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:

C++
Copy 


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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header
Strmif.h (include Dshow.h)

Library
Strmiids.lib

See also

DVD Applications
Error and Success Codes
IDvdInfo2 Interface

 

 

Show: