Metode IPin::NewSegment (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 ini NewSegment memberi tahu pin bahwa sampel media yang diterima setelah panggilan ini dikelompokkan sebagai segmen, dengan waktu mulai, waktu berhenti, dan laju yang umum.
Aplikasi tidak boleh memanggil metode ini. Metode ini dipanggil oleh filter lain.
Sintaks
HRESULT NewSegment(
REFERENCE_TIME tStart,
REFERENCE_TIME tStop,
double dRate
);
Parameter
tStart
Waktu mulai segmen, relatif terhadap sumber asli, dalam unit 100 nanodetik.
tStop
Waktu akhir segmen, relatif terhadap sumber asli, dalam unit 100 nanodetik.
dRate
Tingkat di mana segmen ini harus diproses, sebagai persentase dari tingkat asli.
Nilai kembali
Mengembalikan S_OK jika berhasil, atau nilai HRESULT yang menunjukkan penyebab kesalahan.
Keterangan
Filter sumber (atau filter pengurai) memanggil metode ini di awal setiap aliran baru dan setelah setiap operasi pencarian. Ini memanggil metode pada pin input filter hilir, setelah mengirimkan batch data sebelumnya dan sebelum memanggil IMemInputPin::Receive dengan data baru apa pun. Filter hilir menyebarluaskan panggilan ke NewSegment hilir.
Filter dapat menggunakan informasi segmen untuk memproses sampel. Misalnya, dengan beberapa format tidak mungkin untuk merekonstruksi bingkai delta tanpa bingkai kunci berikutnya. Oleh karena itu, jika waktu berhenti terjadi pada bingkai delta, filter sumber harus mengirim beberapa bingkai tambahan. Filter dekoder menentukan bingkai akhir berdasarkan informasi segmen. Laju segmen digunakan untuk merender sumber data berkelanjutan, seperti data audio. Misalnya, perender audio menggunakan laju pengambilan sampel dan laju segmen untuk merender data audio dengan benar.
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 |