IDvdInfo2::GetAudioAttributes-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 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