Méthode IDvdInfo2 ::GetDVDTextLanguageInfo (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 GetDVDTextLanguageInfo méthode récupère des informations sur les chaînes de texte d’une langue spécifiée. La méthode récupère le nombre de chaînes pour cette langue, l’identificateur de paramètres régionaux et le jeu de caractères.

Syntaxe

HRESULT GetDVDTextLanguageInfo(
  [in]  ULONG           ulLangIndex,
  [out] ULONG           *pulNumOfStrings,
  [out] LCID            *pLangCode,
  [out] DVD_TextCharSet *pbCharacterSet
);

Paramètres

[in] ulLangIndex

Index de base zéro de la langue à interroger. Pour rechercher le nombre de langues de chaîne de texte sur le DVD, appelez IDvdInfo2 ::GetDVDTextNumberOfLanguages.

[out] pulNumOfStrings

Reçoit le nombre de chaînes de texte pour la langue spécifiée.

[out] pLangCode

Reçoit un identificateur de paramètres régionaux (LCID) qui spécifie la langue dans laquelle le texte est écrit. Par exemple, le LCID pour « en-us » est 0x0409.

[out] pbCharacterSet

Reçoit un membre de l’énumération DVD_TextCharSet . La valeur spécifie le jeu de caractères de la chaîne de texte.

Valeur retournée

Retourne l’une des valeurs HRESULT suivantes.

Code de retour	Description
S_OK	Réussite.
E_INVALIDARG	Ce DVD n’a pas de chaînes de texte, ou le paramètre ulLangIndex est hors limites.
E_POINTER	Argument pointeur NULL .
E_UNEXPECTED	Une erreur interne inattendue s’est produite.

Remarques

Pour obtenir une chaîne de texte particulière, appelez IDvdInfo2 ::GetDVDTextStringAsUnicode ou IDvdInfo2 ::GetDVDTextStringAsNative.

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

Utilisation de chaînes de texte DVD

Partager via