Méthode IDvdInfo2 ::GetAudioLanguage (strmif.h)

Article
03/02/2024

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement au nouveau code d’utiliser MediaPlayer, IMFMediaEngine et La capture audio/vidéo dans Media Foundation au lieu de DirectShow, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

La GetAudioLanguage méthode récupère la langue du flux audio spécifié dans le titre actuel.

Syntaxe

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

Paramètres

[in] ulStream

Numéro de flux audio pour la langue récupérée.

[out] pLanguage

Reçoit les informations de langue.

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Argument non valide.
E_POINTER	Le paramètre pLanguage est NULL.
E_UNEXPECTED	Le NAVIGATEUR DE DVD n’est pas initialisé.
VFW_E_DVD_INVALIDDOMAIN	DVD Navigator n’est pas dans un domaine valide.

Remarques

Cette méthode ne retourne pas les langues pour les menus. Il définit la valeur pointée vers pLanguage sur zéro si le flux contient une langue inconnue. Appelez la fonction GetLocaleInfo pour créer un nom de chaîne lisible par l’homme à partir de pLanguage :

C++
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; } }

C++

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;
    }
}

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	strmif.h (include Dshow.h)
Bibliothèque	Strmiids.lib

Voir aussi

DVD Applications

Codes d’erreur et de réussite

IDvdInfo2 Interface