Metode CPullPin.OnError

  • 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 OnError ini dipanggil jika terjadi kesalahan selama streaming. Kelas turunan harus menerapkan metode ini.

Sintaks

virtual void OnError(
   HRESULT hr
) = 0;

Parameter

jam

Menentukan nilai HRESULT yang dikembalikan oleh metode yang gagal.

Mengembalikan nilai

Metode ini tidak mengembalikan nilai.

Keterangan

Objek memanggil metode ini setiap kali terjadi kesalahan yang menghentikan utas penarikan data. Filter dapat menggunakan metode ini untuk memulihkan dari kesalahan streaming dengan anggun. Dalam kebanyakan kasus, kesalahan dikembalikan dari filter upstram, sehingga filter upstram bertanggung jawab untuk melaporkannya ke Filter Graph Manager. Jika kesalahan terjadi di dalam metode CPullPin::Receive , filter Anda harus mengirim peristiwa EC_ERRORABORT . (Lihat IMediaEventSink::Notify.)

Persyaratan

Persyaratan Nilai
Header
Pullpin.h
Pustaka
Strmbase.lib (build ritel);
Strmbasd.lib (build debug)

Lihat juga

Kelas CPullPin