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 |