Bagikan melalui

Metode IPinConnection::NotifyEndOfStream (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 NotifyEndOfStream meminta pemberitahuan dari pin saat kondisi akhir aliran berikutnya terjadi.

Sintaks

HRESULT NotifyEndOfStream(
  [in] HANDLE hNotifyEvent
);

Parameter

[in] hNotifyEvent

Tangani ke objek peristiwa yang akan diberi sinyal pin.

Mengembalikan nilai

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

Menampilkan kode Deskripsi
S_FALSE
 Penanganan aktivitas adalah NULL, tetapi tidak ada penanganan peristiwa yang ada untuk direset.
S_OK
 Penanganan aktivitas telah diatur. (Jika penanganan aktivitas NULL, pemberitahuan peristiwa dibatalkan.)

Keterangan

Metode ini memungkinkan pemanggil untuk mendorong data melalui sebagian grafik filter yang berakhir dengan pin ini.

Misalnya, pemanggil mendorong data dari pin output yang disebut "A" pada satu filter, ke pin input yang disebut "B" pada filter lain, mungkin dengan filter perantara yang menghubungkannya. Urutan peristiwa berikut akan berlangsung.

  1. Penelepon memblokir aliran data di pin A.
  2. Ini panggilan NotifyEndOfStream pada pin B.
  3. Ini memanggil IPin::EndOfStream pada pin input yang terhubung ke pin A.
  4. Saat data yang tersisa berjalan di hilir melalui filter perantara apa pun, filter tersebut menyebarluaskan pemberitahuan akhir aliran.
  5. Saat pin B menerima pemberitahuan end-of-stream, itu memberi sinyal peristiwa yang diberikan dalam parameter hNotifyEvent . Pada saat itu, penelepon dapat dengan aman mengonfigurasi ulang grafik antara pin A dan pin B.
Karena tujuan dari metode ini adalah untuk memungkinkan pemanggil untuk membangun kembali grafik secara dinamis dan kemudian menghidupkan ulang koneksi, pemberitahuan akhir aliran tidak mewakili akhir aliran yang sebenarnya. Oleh karena itu, pin B tidak menyebarluaskan kondisi akhir aliran atau EC_COMPLETE sinyal. Ini adalah pengecualian untuk aturan yang biasa untuk aliran data dalam grafik filter.

Pemanggil bertanggung jawab untuk membatalkan pemberitahuan dengan memanggil metode ini lagi dengan handel peristiwa NULL .

Grafik filter memanggil metode ini di dalam metode IGraphConfig::Reconnect . Jika aplikasi atau filter melakukan konfigurasi ulang dinamis khusus ke grafik (menggunakan metode IGraphConfig::Konfigurasi ulang ), aplikasi atau filter mungkin memanggil metode ini terlebih dahulu untuk mendorong data melalui bagian grafik yang sedang dikonfigurasi ulang.

Persyaratan

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

Lihat juga

Koneksi Ulang Dinamis

Kode Kesalahan dan Keberhasilan

Antarmuka IPinConnection