IDvdInfo2::GetSubpictureAttributes-Methode (strmif.h)
[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 |
|---|---|
|
Erfolg. |
|
Es wurden keine Unterpicture-Streams gefunden. |
|
Ungültiges Argument. |
|
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 |