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

Article
03/06/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 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

Partager via