IPin::BeginFlush-Methode (strmif.h)

  • Artikel

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

Anwendungen sollten diese Methode nicht aufrufen. Diese Methode wird von anderen Filtern aufgerufen, um Daten aus dem Diagramm zu leeren.

Syntax

HRESULT BeginFlush();

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_UNEXPECTED
 Der Pin ist ein Ausgabepin.

Hinweise

Rufen Sie diese Methode nur bei Eingabenadeln auf. Ausgabepins geben E_UNEXPECTED zurück.

In einem Leerungsvorgang verwirft ein Filter alle daten, die er verarbeitet hat. Neue Daten werden abgelehnt, bis die Leerung abgeschlossen ist. Die Leerung wird abgeschlossen, wenn die Upstream pin die IPin::EndFlush-Methode aufruft. Durch Leerung kann das Filterdiagramm reaktionsfähiger sein, wenn Ereignisse den normalen Datenfluss ändern. Beispielsweise wird während einer Suche geleert.

Wenn BeginFlush aufgerufen wird, führt der Filter die folgenden Schritte aus:

  1. Übergibt den IPin::BeginFlush Aufruf nachgeschaltet.
  2. Legt ein internes Flag fest, das dazu führt, dass alle Datenstreamingmethoden fehlschlagen, z. B. IMemInputPin::Receive.
  3. Gibt von allen blockierten Aufrufen der Receive-Methode zurück.
Wenn die BeginFlush Benachrichtigung einen Rendererfilter erreicht, gibt der Renderer alle darin enthaltenen Beispiele frei.

Nachdem BeginFlush aufgerufen wurde, lehnt der Pin alle Stichproben aus Upstream mit dem Rückgabewert S_FALSE ab, bis die IPin::EndFlush-Methode aufgerufen wird.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Datenfluss im Filtergraphen

Fehler- und Erfolgscodes

IPin-Schnittstelle