IFilterChain::P auseChain-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 PauseChain -Methode wechselt alle Filter in einer Filterkette in einen angehaltenen Zustand.

Syntax

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

Parameter

[in] pStartFilter

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

[in] pEndFilter

Ein Zeiger auf die IBaseFilter-Schnittstelle des Filters am Ende der Kette. Wenn dieser Parameter NULL ist, verwendet die Methode die längste mögliche Filterkette, die nach dem Startfilter nachgeschaltet wird.

Rückgabewert

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

Hinweise

Wenn diese Methode einen bestimmten Filter nicht in einen angehaltenen Zustand versetzen kann, beendet sie alle Filter in Kette. Das Filterdiagramm muss angehalten 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