IDvdControl2::SelectKaraokeAudioPresentationMode-Methode (strmif.h)

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die SelectKaraokeAudioPresentationMode -Methode sendet Karaoke-Hilfskanäle an die linken oder rechten Lautsprecher.

Syntax

HRESULT SelectKaraokeAudioPresentationMode(
  [in] ULONG ulMode
);

Parameter

[in] ulMode

Bitweises OR von DVD_KARAOKE_DOWNMIX Enumeration, die angibt, wie die fünf Karaokekanäle zu den Kanälen 0 und 1 heruntergemischt werden, die normalerweise an den linken und rechten Lautsprecher ausgegeben werden.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_PROP_SET_UNSUPPORTED
Der Audiodecoder unterstützt das Downmixen nicht.
VFW_E_DVD_INVALIDDOMAIN
Der DVD-Navigator-Filter befindet sich in einer ungültigen Domäne.
VFW_E_DVD_OPERATION_INHIBITED
Die UOP-Steuerung verbietet den aktuellen Vorgang.

Hinweise

Wenn der DVD-Navigator in den Karaokemodus wechselt, fragt er den Audiodecoder ab, um zu ermitteln, ob er das Karaoke-Downmixing unterstützt. Wenn der Decoder dies unterstützt, werden die Kanäle 2 bis 4 (die Karaoke-Hilfskanäle mit dem Führungsgesang, den Führungsmelodien und den Soundeffekten) stummgeschaltet. Verwenden Sie diese Methode, um einzelne Kanäle zu aktivieren oder zu deaktivieren und sie an die Kanäle 0 und 1 weiterzuleiten.

Diese Methode wird in der DVDSample-Anwendung in CKaraokeDlg::D oModal veranschaulicht.

Die folgende Tabelle enthält den Namen des Anhangs J-Befehls, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname Gültige Domänen
Karaoke_Audio_Presentation_Mode_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

DVD-Karaoke-Eigenschaftssatz

Fehler- und Erfolgscodes

IDvdControl2-Schnittstelle