Freigeben über


CTransformFilter.BeginFlush-Methode

[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 BeginFlush -Methode beginnt einen Leerungsvorgang.

Syntax

virtual HRESULT BeginFlush();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK oder einen anderen HRESULT-Wert zurück.

Bemerkungen

Zu Beginn eines Leervorgangs ruft die CTransformInputPin::BeginFlush-Methode des Eingabenadels diese Methode auf. Diese Methode übergibt den BeginFlush Aufruf nachgeschaltet.

Wenn die abgeleitete Klasse einen Workerthread verwendet, um Beispiele zu liefern, sollten alle in die Warteschlange eingereihten Daten während eines Leervorgangs verwerfen. Dies kann entweder in der BeginFlush -Methode oder in der EndFlush-Methode erfolgen. Beachten Sie jedoch, dass Aufrufe von BeginFlush nicht mit dem Streamingthread synchronisiert werden. Wenn die BeginFlush -Methode die in die Warteschlange eingereihten Daten verwirft, muss der Filter darauf achten, dass keine weiteren Daten zwischen den BeginFlushUnd EndFlush-Aufrufen verarbeitet werden. Weitere Informationen finden Sie unter Datenfluss für Filterentwickler.

Anforderungen

Anforderung Wert
Header
Transfrm.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CTransformFilter-Klasse