IDvdInfo2::GetCurrentSubpicture-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 GetCurrentSubpicture -Methode ruft die Anzahl der verfügbaren Unterpicture-Streams im aktuellen Titel, die aktuell ausgewählte Unterbilddatenstromnummer und den Zustand der Unterpicture ab.

Syntax

HRESULT GetCurrentSubpicture(
  [out] ULONG *pulStreamsAvailable,
  [out] ULONG *pulCurrentStream,
  [out] BOOL  *pbIsDisabled
);

Parameter

[out] pulStreamsAvailable

Empfängt die Anzahl der verfügbaren Unterpicture-Streams.

[out] pulCurrentStream

Empfängt die Nummer des aktuell ausgewählten Teildatenstroms.

[out] pbIsDisabled

Empfängt einen booleschen Wert, der angibt, ob die Unterbildanzeige deaktiviert ist; TRUE bedeutet, dass es deaktiviert ist.

Rückgabewert

Gibt einen der folgenden HRESULT-Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_POINTER
 Ungültiges Argument.
VFW_E_DVD_INVALIDDOMAIN
 Der DVD-Navigator wird nicht oder nicht in der Titeldomäne initialisiert.

Hinweise

Dvd-Inhaltsautoren können angeben, dass jeder bestimmte Unterpicture-Stream auf einem Datenträger erzwungen aktiviert wird, was bedeutet, dass die DVD-Autoren diesen Stream benötigen, um anzuzeigen, ob der Betrachter ihn watch möchte oder nicht. Der DVD-Navigator erfüllt alle derartigen Befehle vom Datenträger, was bedeutet, dass erzwungen aktivierte Streams angezeigt werden, auch wenn die Anwendung die Unterpicture-Anzeige mit der IDvdControl2::SetSubpictureState-Methode deaktiviert hat.

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

EC_DVD_SUBPICTURE_STREAM_CHANGE

Fehler- und Erfolgscodes

IDvdInfo2-Schnittstelle