Fungsi KsFilterAttemptProcessing (ks.h)
Fungsi KsFilterAttemptProcessing mencoba memulai pemrosesan pada Filter.
Sintaks
void KsFilterAttemptProcessing(
[in] PKSFILTER Filter,
[in] BOOLEAN Asynchronous
);
Parameter
[in] Filter
Penunjuk ke struktur KSFILTER yang mewakili objek filter AVStream untuk mencoba pemrosesan.
[in] Asynchronous
Parameter ini berisi indikasi apakah pengiriman pemrosesan harus terjadi secara asinkron atau tidak (jika terjadi). Pengiriman asinkron dijamin jika ini BENAR; namun, pengiriman pemrosesan sinkron diatur oleh kondisi yang dijelaskan di bawah ini.
Nilai kembali
Tidak ada
Keterangan
Jika minidriver memanggil KsFilterAttemptProcessing ketika semua kondisi yang diperlukan untuk memproses data terpenuhi, pengiriman pemrosesan terjadi. Untuk informasi selengkapnya tentang panggilan balik proses, lihat KSFILTER_DISPATCH. Agar upaya menghasilkan pengiriman aktual, gerbang kontrol proses filter harus dalam keadaan terbuka. Tidak seperti pemrosesan yang berpusat pada pin, pemrosesan yang berpusat pada filter memiliki banyak kondisi yang memengaruhi gerbang kontrol proses. Untuk informasi selengkapnya tentang persyaratan ini, lihat Pemrosesan Filter-Sentris dan Pemrosesan Pin-Sentris.
Jika gerbang kontrol proses terbuka, pengiriman pemrosesan terjadi, baik secara sinkron atau asinkron. Jika pemanggil menentukan TRUE dalam parameter Asinkron , pengiriman pemrosesan selalu terjadi secara asinkron dalam item kerja. Namun, jika pemanggil meminta pengiriman pemrosesan sinkron, pengiriman terjadi secara sinkron hanya jika sistem saat ini berada di IRQL tempat minidriver dapat menangani pemrosesan. Jika sistem berada di PASSIVE_LEVEL, pengiriman dijamin terjadi secara sinkron. Sebaliknya, jika sistem berada di DISPATCH_LEVEL, pengiriman terjadi secara sinkron hanya jika KSFILTER_FLAG_DISPATCH_LEVEL_PROCESSING ditentukan pada filter. Jika tidak, item kerja diantrekan untuk melakukan pemrosesan.
Perhatikan bahwa ini hanya upaya pemrosesan; memanggil fungsi ini tidak menjamin bahwa pemrosesan akan dimulai. Pemrosesan hanya terjadi jika gerbang kontrol proses "terbuka." Untuk informasi selengkapnya, lihat Memulai Ulang Pemrosesan di AVStream dan Gerbang Kontrol Alur di AVStream.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |