IDvdInfo2::GetKaraokeAttributes-Methode (strmif.h)

  • Artikel

[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 GetKaraokeAttributes -Methode ruft die Karaoke-Attribute des angegebenen Audiostreams im aktuellen Titel oder Menü ab.

Syntax

HRESULT GetKaraokeAttributes(
  [in]  ULONG                 ulStream,
  [out] DVD_KaraokeAttributes *pAttributes
);

Parameter

[in] ulStream

Gibt den Index des Audiostreams an, dessen Attribute Sie abfragen möchten. Siehe Hinweise.

[out] pAttributes

Zeiger auf eine DVD_KaraokeAttributes Struktur, die mit den Karaokeattributen gefüllt ist.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_POINTER
 Ungültiges Argument.
E_UNEXPECTED
 Der DVD-Navigator wird nicht initialisiert.
VFW_E_DVD_NOT_IN_KARAOKE_MODE
 Der angegebene Stream hat kein Karaoke-Format.
VFW_E_DVD_INVALIDDOMAIN
 Der DVD-Navigator befindet sich nicht in der Titeldomäne.
VFW_E_DVD_NO_ATTRIBUTES
 Die Karaokeattribute für den angegebenen Stream sind nicht verfügbar.

Hinweise

Diese Methode gibt die Anzahl der Kanäle im Stream nicht explizit zurück. Sie können diese Informationen über einen Aufruf von IDvdInfo2::GetAudioAttributes abrufen. Diese Methode wird in der DVDSample-Anwendung in CKaraokeDlg::D oModal veranschaulicht.

Der ulStream-Parameter kann ein Wert von 0 bis 7 oder einer der folgenden Werte sein:

Wert BESCHREIBUNG
DVD_STREAM_DATA_CURRENT (0x800) So fragen Sie den aktuell ausgewählten Audiodatenstrom ab.
DVD_DEFAULT_AUDIO_STREAM So fragen Sie den Standardaudiostream ab.

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

IDvdInfo2-Schnittstelle