IDvdControl2::SelectAudioStream-Methode (strmif.h)

Artikel
03/04/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die SelectAudioStream -Methode wählt den audiostream aus, der wiedergegeben werden soll.

Syntax

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

Parameter

[in] ulAudio

Wert, der den Audiostream angibt. Gültige Streamnummern sind 0 bis 7 oder DVD_DEFAULT_AUDIO_STREAM , um den Standardstream anzugeben.

[in] dwFlags

Bitweise OR eines oder mehrerer Flags aus der DVD_CMD_FLAGS-Enumeration , die angibt, wie der Befehl synchronisiert werden soll. Dieser Parameter wird derzeit ignoriert. verwenden Sie DVD_CMD_FLAG_None.

[out] ppCmd

Empfängt einen Zeiger auf ein IDvdCmd-Objekt , das zum Synchronisieren von DVD-Befehlen verwendet werden kann. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Synchronisieren von DVD-Befehlen.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
S_FALSE	Es wurde kein Standardaudiostream gefunden. oder dwFlags ist nicht 0.
S_OK	Erfolg.
E_INVALIDARG	ulAudio liegt außerhalb des Bereichs oder entspricht keinem Audiostream.
E_UNEXPECTED	Der ulAudio-Wert ist gültig, aber der DVD Navigator konnte ihn aus irgendeinem Grund nicht festlegen.
VFW_E_DVD_OPERATION_INHIBITED	Die UOP-Steuerung verbietet den Vorgang.
VFW_E_DVD_STREAM_DISABLED	Der angegebene Stream ist deaktiviert.

Hinweise

Diese Methode wirkt sich auf die Audiowiedergabe des aktuellen Video Title Set (VTS) aus. Wenn sie in einem Menü aufgerufen wird, legt diese Methode den Audiostream des Titels fest, aus dem das Menü aufgerufen wurde.

Die folgende Tabelle zeigt den Anhang J-Befehlsnamen, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname	Gültige Domänen
Audio_Stream_Change	DVD_DOMAIN_VideoManagerMenu DVD_DOMAIN_VideoTitleSetMenu DVD_DOMAIN_Title DVD_DOMAIN_Stop

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	strmif.h (include Dshow.h)
Bibliothek	Strmiids.lib

Weitere Informationen

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdControl2-Schnittstelle

Freigeben über