Méthode IDvdControl2 ::SelectAudioStream (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 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 SelectAudioStream méthode sélectionne le flux audio à lire.

Syntaxe

HRESULT SelectAudioStream(
  [in]  ULONG   ulAudio,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Paramètres

[in] ulAudio

Valeur qui spécifie le flux audio. Les nombres de flux valides sont de 0 à 7, ou DVD_DEFAULT_AUDIO_STREAM pour spécifier le flux par défaut.

[in] dwFlags

OR au niveau du bit d’un ou de plusieurs indicateurs de l’énumération DVD_CMD_FLAGS , en spécifiant comment synchroniser la commande. Ce paramètre est actuellement ignoré ; utilisez DVD_CMD_FLAG_None.

[out] ppCmd

Reçoit un pointeur vers un objet IDvdCmd qui peut être utilisé pour synchroniser des commandes DVD. L’appelant doit libérer l’interface. Ce paramètre peut être NULL. Pour plus d’informations, consultez Synchronisation des commandes DVD.

Valeur retournée

Retourne l’une des valeurs suivantes.

Code de retour Description
S_FALSE
 Aucun flux audio par défaut n’a été trouvé ; ou dwFlags n’est pas égal à zéro.
S_OK
 Réussite.
E_INVALIDARG
 ulAudio est hors de portée ou ne correspond pas à un flux audio.
E_UNEXPECTED
 La valeur ulAudio est valide, mais le NAVIGATEUR DE DVD n’a pas pu la définir pour une raison quelconque.
VFW_E_DVD_OPERATION_INHIBITED
 Le contrôle UOP interdit l’opération.
VFW_E_DVD_STREAM_DISABLED
 Le flux spécifié est désactivé.

Remarques

Cette méthode affecte l’audio du jeu de titres vidéo (VTS) actuel. Lorsqu’elle est appelée à partir d’un menu, cette méthode définit le flux audio du titre à partir duquel le menu a été appelé.

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

Nom de la commande Annexe J Domaines valides
Audio_Stream_Change
  • DVD_DOMAIN_VideoManagerMenu
  • DVD_DOMAIN_VideoTitleSetMenu
  • DVD_DOMAIN_Title
  • 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