IMFSourceReader::Flush-Methode (mfreadwrite.h)

  • Artikel

Leert mindestens einen Datenstrom.

Syntax

HRESULT Flush(
  [in] DWORD dwStreamIndex
);

Parameter

[in] dwStreamIndex

Der zu leerende Stream. Der Wert kann einer der folgenden Werte sein.

Wert Bedeutung
0–0xFFFFFFFB
 Der nullbasierte Index eines Streams.
MF_SOURCE_READER_FIRST_VIDEO_STREAM
0xFFFFFFFC
 Der erste Videostream.
MF_SOURCE_READER_FIRST_AUDIO_STREAM
0xFFFFFFFD
 Der erste Audiostream.
MF_SOURCE_READER_ALL_STREAMS
0xFFFFFFFE
 Alle Streams.

Rückgabewert

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

Hinweise

Die Flush-Methode verwirft alle in der Warteschlange befindlichen Beispiele und bricht alle ausstehenden Beispielanforderungen ab.

Diese Methode kann entweder synchron oder asynchron abgeschlossen werden.

Wenn Sie beim Erstellen des Quelllesers einen Rückrufzeiger bereitstellen, ist die Methode asynchron. Andernfalls ist die Methode synchron. Weitere Informationen zum Festlegen 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 Löschvorgang abgeschlossen ist. Während ein Leervorgang aussteht, gibt die IMFSourceReader::ReadSample-MethodeMF_E_NOTACCEPTING zurück.

Hinweis In Windows 7 gab es einen Fehler bei der Implementierung dieser Methode, der dazu führt, dass OnFlush aufgerufen wird, bevor der Löschvorgang abgeschlossen ist. Früher war ein Hotfix verfügbar, der diesen Fehler behoben hat.
 
Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfreadwrite.h

Weitere Informationen

IMFSourceReader

Quellleser