IDvdInfo2::GetAudioAttributes-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 GetAudioAttributes -Methode ruft die Attribute des angegebenen Audiostreams im aktuellen Titel oder Menü ab.

Syntax

HRESULT GetAudioAttributes(
  [in]  ULONG               ulStream,
  [out] DVD_AudioAttributes *pATR
);

Parameter

[in] ulStream

Variable vom Typ ULONG, die den Audiostream angibt, dessen Attribute Sie abfragen möchten. Siehe Hinweise.

[out] pATR

Zeiger auf eine DVD_AudioAttributes Struktur, die mit den Attributen des angegebenen Audiodatenstroms gefüllt ist.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_UNEXPECTED	Der DVD-Navigator wird nicht initialisiert.
VFW_E_DVD_NO_ATTRIBUTES	Die Audioattribute des Streams sind nicht verfügbar.
E_POINTER	Ungültiges Argument.

Hinweise

ulStream kann eine beliebige Indexnummer von 0 bis 7 oder einer der folgenden Werte sein:

Wert	BESCHREIBUNG
DVD_DEFAULT_AUDIO_STREAM	So fragen Sie die Attribute des Standardaudiodatenstroms ab.
DVD_STREAM_DATA_CURRENT	So fragen Sie den aktuellen Stream ab.
DVD_STREAM_DATA_VMGM	Um die Audioattribute der VMGM abzufragen.
DVD_STREAM_DATA_VTSM	So fragen Sie nach den Audioattributen des VTSM ab.

Die Verwendung dieser Methode wird in der DVDSample-Anwendung in CDvdCore::GetAudioAttributes und CAudioLangDlg::GetAudioLang veranschaulicht.

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