IPin::BeginFlush method (strmif.h)
[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 |
|---|---|
|
Berhasil. |
|
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:
- Melewati panggilan hilir
IPin::BeginFlush. - Mengatur bendera internal yang menyebabkan semua metode streaming data gagal, seperti IMemInputPin::Receive.
- 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 |