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

Syntax

HRESULT GetSubpictureAttributes(
  [in]  ULONG                    ulStream,
  [out] DVD_SubpictureAttributes *pATR
);

Parameter

[in] ulStream

Indexnummer von 0 bis 31 des Teildatenstroms zur Abfrage. Siehe Hinweise.

[out] pATR

Zeiger auf eine DVD_SubpictureAttributes Struktur, die die Unterpicture-Attribute empfängt.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode Beschreibung
S_OK
 Erfolg.
E_FAIL
 Es wurden keine Unterpicture-Streams gefunden.
E_POINTER
 Ungültiges Argument.
VFW_E_DVD_NO_ATTRIBUTES
 Die Unterpicture weist keine definierten Attribute auf.

Bemerkungen

Die Indexnummern 0-31 sind nur für Titel gültig. Menüs verfügen nur über einen Teildatenstrom, der mithilfe einer der Konstanten in der folgenden Tabelle angegeben werden muss:

Wert Beschreibung
DVD_STREAM_DATA_CURRENT (0x800) So fragen Sie den aktuell ausgewählten Unterpicture-Stream ab.
DVD_STREAM_DATA_VMGM (0x400) Um die Unterpictureattribute für den Video-Manager oder das Menü "Oben" abzufragen.
DVD_STREAM_DATA_VTSM (0x401) So fragen Sie die Unterbildattribute für das aktuell ausgewählte Videotitelsatzmenü ab.
 

Diese Methode wird in der DVDSample-Anwendung in CDvdCore::GetSPAttributes() und CSPLangDlg::GetSPLang veranschaulicht.

Anforderungen

   
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

Siehe auch

DVD-Anwendungen

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle

Arbeiten mit DVD-Menüs