Méthode IDvdControl2 ::SelectDefaultAudioLanguage (strmif.h)

  • Article

[La fonctionnalité associée à cette page, DirectShow, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer, IMFMediaEngine et Audio/Video Capture in Media Foundation. Ces fonctionnalités ont été optimisées pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer, IMFMediaEngine et Audio/Video Capture dans Media Foundation au lieu de DirectShow, si 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 SelectDefaultAudioLanguage méthode définit la langue audio par défaut.

Syntaxe

HRESULT SelectDefaultAudioLanguage(
  [in] LCID               Language,
  [in] DVD_AUDIO_LANG_EXT audioExtension
);

Paramètres

[in] Language

Identificateur de paramètres régionaux qui spécifie la langue par défaut.

[in] audioExtension

DVD_AUDIO_LANG_EXT énumération qui spécifie l’extension de langage audio par défaut.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 Réussite.
E_INVALIDARG
 La valeur audioExtension n’est pas valide.
VFW_E_DVD_INVALIDDOMAIN
 Le filtre Dvd Navigator ne se trouve pas dans le domaine Arrêter.

Remarques

Cette méthode sélectionne la langue et les extensions de langage par défaut à utiliser lors de la lecture du disque. Par exemple, si Language est spécifié comme 0x409 pour l’anglais et qu’audioExtension est spécifié comme DVD_AUD_EXT_NotSpecified, le navigateur de DVD recherche le flux audio de base en anglais. Si audioExtension est spécifié comme DVD_AUD_EXT_VisuallyImpaired, le navigateur de DVD recherche d’abord un flux audio spécial en anglais pour les personnes malvoyantes. Si le flux par défaut est introuvable sur un disque, le Navigateur de DVD sélectionne la correspondance la plus proche.

Le tableau suivant indique le nom de la commande Annexe J auquel ce nom de méthode correspond et les domaines dans lesquels cette méthode est valide.

Nom de la commande Annexe J Domaines valides
None DVD_DOMAIN_Stop

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

IDvdControl2, interface