Antarmuka IMediaSeeking (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.]
Antarmuka IMediaSeeking berisi metode untuk mencari posisi dalam aliran, dan untuk mengatur laju pemutaran. Filter Graph Manager mengekspos antarmuka ini, dan begitu juga filter atau pin individual. Aplikasi harus mengkueri Filter Graph Manager untuk antarmuka.
Filter Graph Manager mendistribusikan panggilan apa pun IMediaSeeking ke setiap filter perender dalam grafik. Filter perender mengirim panggilan upstream ke filter sumber. Urutan peristiwa ini memastikan bahwa semua aliran tetap disinkronkan. Jika salah satu panggilan terdistribusi mengembalikan kesalahan, Filter Graph Manager mengembalikan nilai kesalahan pertama yang diterimanya, bahkan jika beberapa panggilan terdistribusi berhasil. Pengecualian E_NOTIMPL: Filter Graph Manager tidak mengembalikan E_NOTIMPL kecuali dikembalikan oleh semua panggilan terdistribusi.
Aplikasi dapat mencari grafik saat grafik dalam status apa pun (berjalan, dijeda, atau dihentikan). Jika grafik berjalan, Filter Graph Manager menjeda grafik sebelum mengeluarkan perintah pencarian. Kemudian menjalankan grafik lagi. Semua operasi pencarian tidak bergantung pada laju pemutaran saat ini. Mencari operasi menyebabkan data media yang tertunda dihapus dari grafik.
Untuk semua IMediaSeeking parameter yang menentukan waktu, unit waktu bergantung pada format waktu saat ini. Untuk mengatur format waktu, panggil metode IMediaSeeking::SetTimeFormat . Format waktu adalah pengidentifikasi unik global (GUID) yang ditentukan dalam uuids.h. Untuk informasi selengkapnya, lihat Format Waktu GUID.
Warisan
Antarmuka IMediaSeeking mewarisi dari antarmuka IUnknown . IMediaSeeking juga memiliki jenis anggota ini:
Metode
Antarmuka IMediaSeeking memiliki metode ini.
| IMediaSeeking::CheckCapabilities Metode CheckCapabilities meminta apakah aliran telah menentukan kemampuan pencarian. |
| IMediaSeeking::ConvertTimeFormat Metode ConvertTimeFormat dikonversi dari format satu kali ke format lainnya. |
| IMediaSeeking::GetAvailable Metode GetAvailable mengambil rentang waktu di mana pencarian efisien. |
| IMediaSeeking::GetCapabilities Metode GetCapabilities mengambil semua kemampuan pencarian aliran. |
| IMediaSeeking::GetCurrentPosition Metode GetCurrentPosition mengambil posisi saat ini, relatif terhadap total durasi aliran. |
| IMediaSeeking::GetDuration Metode GetDuration mendapatkan durasi aliran. |
| IMediaSeeking::GetPositions Metode GetPositions mengambil posisi saat ini dan posisi berhenti, relatif terhadap total durasi aliran. |
| IMediaSeeking::GetPreroll Metode GetPreroll mengambil jumlah data yang akan diantrekan sebelum posisi mulai. |
| IMediaSeeking::GetRate Metode GetRate mengambil laju pemutaran. |
| IMediaSeeking::GetStopPosition Metode GetStopPosition mengambil waktu di mana pemutaran akan berhenti, relatif terhadap durasi aliran. |
| IMediaSeeking::GetTimeFormat Metode GetTimeFormat mengambil format waktu yang saat ini digunakan untuk operasi pencarian. |
| IMediaSeeking::IsFormatSupported Metode IsFormatSupported menentukan apakah format waktu tertentu didukung untuk operasi pencarian. |
| IMediaSeeking::IsUsingTimeFormat Metode IsUsingTimeFormat menentukan apakah operasi pencarian saat ini menggunakan format waktu yang ditentukan. |
| IMediaSeeking::QueryPreferredFormat Metode QueryPreferredFormat mengambil format waktu yang disukai untuk pencarian. |
| IMediaSeeking::SetPositions Metode SetPositions mengatur posisi saat ini dan posisi berhenti. |
| IMediaSeeking::SetRate Metode SetRate menetapkan laju pemutaran. |
| IMediaSeeking::SetTimeFormat Metode SetTimeFormat mengatur format waktu untuk operasi pencarian berikutnya. |
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) |