Bagikan melalui

IPin::BeginFlush method (strmif.h)

  • Artikel

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine dan Audio/Video Capture di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode memulai BeginFlush operasi flush.

Aplikasi tidak boleh memanggil metode ini. Metode ini dipanggil oleh filter lain, untuk menghapus data dari grafik.

Sintaks

HRESULT BeginFlush();

Mengembalikan nilai

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang berikut ini.

Menampilkan kode Deskripsi
S_OK
 Berhasil.
E_UNEXPECTED
 Pin adalah pin output.

Keterangan

Panggil metode ini hanya pada pin input. Pin output mengembalikan E_UNEXPECTED.

Dalam operasi flush, filter membuang data apa pun yang diprosesnya. Ini menolak data baru sampai flush selesai. Flush selesai ketika pin upstram memanggil metode IPin::EndFlush . Flushing memungkinkan grafik filter menjadi lebih responsif ketika peristiwa mengubah aliran data normal. Misalnya, pembersihan terjadi selama pencarian.

Ketika BeginFlush dipanggil, filter melakukan langkah-langkah berikut:

  1. Melewati panggilan hilir IPin::BeginFlush .
  2. Mengatur bendera internal yang menyebabkan semua metode streaming data gagal, seperti IMemInputPin::Receive.
  3. Mengembalikan dari setiap panggilan yang diblokir ke metode Terima .
BeginFlush Saat pemberitahuan mencapai filter perender, perender membebaskan sampel apa pun yang dipegangnya.

Setelah BeginFlush dipanggil, pin menolak semua sampel dari hulu, dengan nilai pengembalian S_FALSE, hingga metode IPin::EndFlush dipanggil.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung Windows 2000 Server [hanya aplikasi desktop]
Target Platform Windows
Header strmif.h (termasuk Dshow.h)
Pustaka Strmiids.lib

Lihat juga

Aliran Data di Grafik Filter

Kode Kesalahan dan Keberhasilan

Antarmuka IPin