IFilterChain::Metode StartChain (strmif.h)
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan 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 Pengambilan Audio/Video 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 mengalihkan StartChain semua filter dalam rantai filter ke status berjalan.
Sintaks
HRESULT StartChain(
[in] IBaseFilter *pStartFilter,
[in] IBaseFilter *pEndFilter
);
Parameter
[in] pStartFilter
Penunjuk ke antarmuka IBaseFilter filter di awal rantai.
[in] pEndFilter
Arahkan ke filter di akhir rantai. Jika parameter ini NULL, metode ini menggunakan rantai filter terpanjang yang memperluas hilir dari filter mulai.
Nilai kembali
Mengembalikan S_OK jika berhasil. Jika metode gagal, nilai yang dikembalikan mungkin VFW_E_NOT_RUNNING atau nilai HRESULT lainnya.
Keterangan
Jika metode ini tidak dapat mengalihkan filter yang diberikan ke status berjalan, metode ini meninggalkan semua filter dalam status berhenti. Grafik filter harus berjalan saat Anda memanggil metode ini.
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 |