IDvdControl2::P layChaptersAutoStop-Methode (strmif.h)

Artikel
03/02/2024

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die PlayChaptersAutoStop -Methode gibt die Anzahl der angegebenen Kapitel ab dem angegebenen Kapitel innerhalb des angegebenen Titels wieder.

Syntax

HRESULT PlayChaptersAutoStop(
  [in]  ULONG   ulTitle,
  [in]  ULONG   ulChapter,
  [in]  ULONG   ulChaptersToPlay,
  [in]  DWORD   dwFlags,
  [out] IDvdCmd **ppCmd
);

Parameter

[in] ulTitle

Wert, der den Titel angibt, in dem sich das Kapitel befindet; Dieser Wert muss zwischen 1 und 99 sein.

[in] ulChapter

Wert, der das Kapitel im angegebenen Titel angibt, in dem der DVD-Navigator mit der Wiedergabe beginnt; Dieser Wert muss zwischen 1 und 999 sein.

[in] ulChaptersToPlay

Anzahl der Kapitel, die ab dem Anfangskapitel wiedergegeben werden sollen.

[in] dwFlags

Bitweises OR eines oder mehrerer Flags aus der DVD_CMD_FLAGS-Enumeration, die angibt, wie der Befehl synchronisiert werden soll.

[out] ppCmd

Empfängt einen Zeiger auf ein IDvdCmd-Objekt , das zum Synchronisieren von DVD-Befehlen verwendet werden kann. Der Aufrufer muss die Schnittstelle freigeben. Dieser Parameter kann NULL sein. Weitere Informationen finden Sie unter Synchronisieren von DVD-Befehlen.

Rückgabewert

Gibt einen der folgenden Werte zurück.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_UNEXPECTED	Der DVD-Navigator wird nicht initialisiert, oder der Titel ist kein 1 sequenzieller PGC-Titel.
E_INVALIDARG	Der ulTitle-Wert ist nicht vorhanden oder größer als die Anzahl der Titel, oder ulChapter ist nicht vorhanden oder größer als die Anzahl der Kapitel, oder ulChapter plus ulChaptersToPlay ist größer als die Anzahl der Kapitel.
VFW_E_DVD_GRAPHNOTREADY	Das Diagramm befindet sich nicht im Ausführungszustand.

Hinweise

Diese Methode funktioniert nur für One_Sequential_PGC_Titles. Wenn die angegebene Anzahl von Kapiteln wiedergegeben wurde, sendet der DVD-Navigator der Anwendung eine EC_DVD_CHAPTER_AUTOSTOP Ereignisbenachrichtigung.

Die folgende Tabelle enthält den Namen des Anhangs J-Befehls, dem dieser Methodenname entspricht, und die Domänen, in denen diese Methode gültig ist.

Anhang J Befehlsname	Gültige Domänen
Keine.	Alle.

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

IDvdControl2-Schnittstelle

Synchronisieren von DVD-Befehlen

Freigeben über