IDvdInfo2::GetKaraokeAttributes-Methode (strmif.h)

Artikel
03/02/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 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

Freigeben über