Freigeben über


CBaseInputPin.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 CBaseInputPin -Methode beginnt einen Leerungsvorgang. Diese Methode implementiert die IPin::BeginFlush-Methode .

Syntax

HRESULT BeginFlush();

Parameter

Diese Methode hat keine Parameter.

Rückgabewert

Gibt S_OK zurück.

Bemerkungen

Diese Methode legt das CBaseInputPin::m_bFlushing-Flag auf TRUE fest, wodurch die CBaseInputPin::Receive-Methode alle weiteren Beispiele ablehnt.

Die abgeleitete Klasse muss diese Methode überschreiben und die folgenden Schritte ausführen:

  1. Rufen Sie die IPin::BeginFlush-Methode für nachgeschaltete Eingabepins auf. Wenn der Pin noch keine Medienbeispiele nachgeschaltet hat, können Sie diesen Schritt überspringen. Wenn Ihre Ausgabepins von der CBaseOutputPin-Klasse abgeleitet sind, können Sie die CBaseOutputPin::D eliverBeginFlush-Methode aufrufen.
  2. Rufen Sie die Basisklassenmethode auf.
  3. Beginnen Sie mit dem Verwerfen von Daten in die Warteschlange.
  4. Gibt von allen blockierten Aufrufen der Receive-Methode zurück.

Anforderungen

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

Siehe auch

CBaseInputPin-Klasse