Méthode IDvdInfo2 ::GetSubpictureLanguage (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 GetSubpictureLanguage méthode récupère la langue du flux de sous-image spécifié dans le titre actuel.

Syntaxe

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

Paramètres

[in] ulStream

Numéro du flux de sous-image pour lequel la langue est récupérée.

[out] pLanguage

Pointeur vers un LCID qui reçoit les informations de paramètres régionaux. Les informations de langue peuvent ensuite être extraites du LCID à l’aide de la macro WIN32 MAKELANGID .

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Argument non valide.
VFW_E_DVD_INVALIDDOMAIN	Le NAVIGATEUR DE DVD n’est pas initialisé ou n’est pas dans un domaine valide.

Remarques

Pour obtenir les langues de texte disponibles pour un menu, appelez GetMenuLanguages. GetSubpictureLanguage définit la valeur pointée vers pLanguage sur zéro si le flux contient une langue inconnue. Appelez la fonction GetLocaleInfo Win32 comme suit pour créer un nom de chaîne lisible par l’utilisateur à partir de pLanguage :

C++
LCID Language; hr = pDvdInfo->GetSubpictureLanguage(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->GetSubpictureLanguage(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