Freigeben über

IMFSourceReader::Flush-Methode (mfreadwrite.h)

Löscht einen oder mehrere Datenströme.

Syntax

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Die Parameter

[in] dwStreamIndex

Der zu leerende Datenstrom. Der Wert kann eine der folgenden Sein:

Wert Bedeutung
0–0xFFFFFFFB
 Der nullbasierte Index eines Datenstroms.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 Der erste Audiodatenstrom.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
 Alle Datenströme.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Bemerkungen

Die Flush-Methode verwirft alle in die Warteschlange eingereihten Beispiele und bricht alle ausstehenden Beispielanforderungen ab.

Diese Methode kann synchron oder asynchron abgeschlossen werden.

Wenn Sie beim Erstellen des Quelllesers einen Rückrufzeiger angeben, ist die Methode asynchron. Andernfalls ist die Methode synchron. Weitere Informationen zur Einstellung des Rückrufzeigers finden Sie unter MF_SOURCE_READER_ASYNC_CALLBACK.

Im synchronen Modus blockiert die Methode, bis der Vorgang abgeschlossen ist.

Im asynchronen Modus wird die IMFSourceReaderCallback::OnFlush-Methode der Anwendung aufgerufen, wenn der Flush-Vorgang abgeschlossen ist. Während ein Leervorgang aussteht, gibt die IMFSourceReader::ReadSample-MethodeMF_E_NOTACCEPTING zurück.

Anmerkung In Windows 7 gab es einen Fehler bei der Implementierung dieser Methode, wodurch OnFlush aufgerufen wird, bevor der Löschvorgang abgeschlossen ist. Ein Hotfix wurde verwendet, um verfügbar zu sein, der diesen Fehler behoben hat.
 
Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdate-Ergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Ergänzung zu Windows 7, Windows Vista und Platform Update für Windows Vista [Desktop-Apps | UWP-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Fenster
Header mfreadwrite.h

Siehe auch

IMFSourceReader-

Quellleser

  • Last updated on