IFilterChain::StartChain-Methode (strmif.h)

[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 StartChain -Methode wechselt alle Filter in einer Filterkette in einen ausgeführten Zustand.

Syntax

HRESULT StartChain(
  [in] IBaseFilter *pStartFilter,
  [in] IBaseFilter *pEndFilter
);

Parameter

[in] pStartFilter

Ein Zeiger auf die IBaseFilter-Schnittstelle des Filters am Anfang der Kette.

[in] pEndFilter

Zeiger auf den Filter am Ende der Kette. Wenn dieser Parameter NULL ist, verwendet die -Methode die längste mögliche Filterkette, die sich nach dem Startfilter erstreckt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Wenn die Methode fehlschlägt, kann der Rückgabewert VFW_E_NOT_RUNNING oder ein anderer HRESULT-Wert sein.

Hinweise

Wenn diese Methode einen bestimmten Filter nicht in den Status "Wird ausgeführt" umschalten kann, wird der Status "Beendet" für alle Filter beibehalten. Das Filterdiagramm muss ausgeführt werden, wenn Sie diese Methode aufrufen.

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

Fehler- und Erfolgscodes

IFilterChain-Schnittstelle