Méthode IDvdControl2 ::SelectDefaultSubpictureLanguage (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 SelectDefaultSubpictureLanguage méthode définit la langue par défaut du texte de sous-image.

Syntaxe

HRESULT SelectDefaultSubpictureLanguage(
  [in] LCID                    Language,
  [in] DVD_SUBPICTURE_LANG_EXT subpictureExtension
);

Paramètres

[in] Language

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

[in] subpictureExtension

DVD_SUBPICTURE_LANG_EXT énumération qui spécifie l’extension de sous-image par défaut.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 Réussite.
E_INVALIDARG
 La langue n’est pas valide.
VFW_E_DVD_INVALIDDOMAIN
 Le filtre Navigateur de DVD n’est pas dans un domaine valide.

Remarques

Cette méthode sélectionne la langue et le format par défaut à utiliser pour les sous-images et les menus lorsque le disque est lu. Par exemple, si Language est spécifié comme 0x409 pour l’anglais américain et que subpictureExtension est spécifié en tant que DVD_SP_EXT_Caption_Big, le Navigateur de DVD tente d’afficher du texte anglais américain au format « Big légende » dans les sous-représentations. Si la langue par défaut ou l’extension de langue 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