Fungsi KsPinAttemptProcessing (ks.h)

  • Artikel

Fungsi KsPinAttemptProcessing digunakan untuk melanjutkan pemrosesan pada pin tertentu pada filter yang berpusat pada pin. Ini mencoba untuk memulai pemrosesan pada Pin dengan mengirim panggilan pengiriman pemrosesan ke objek pemrosesan Pin.

Sintaks

void KsPinAttemptProcessing(
  [in] PKSPIN  Pin,
  [in] BOOLEAN Asynchronous
);

Parameter

[in] Pin

Penunjuk ke struktur KSPIN yang mewakili objek pin AVStream untuk mencoba pemrosesan.

Peringatan

Parameter ini bersifat wajib. Jika Anda memanggil KsPinAttemptProcessing dengan nilai PinNULL, ketidakstabilan sistem dapat dihasilkan.

[in] Asynchronous

Parameter ini menunjukkan preferensi minidriver apakah pemrosesan harus terjadi secara sinkron atau asinkron. Jika TRUE, pemrosesan selalu asinkron. Namun, pemrosesan sinkron hanya terjadi dalam keadaan tertentu. Untuk informasi selengkapnya, lihat bagian Keterangan di bawah ini.

Nilai kembali

Tidak ada

Keterangan

Minidriver mungkin perlu memanggil KsPinAttemptProcessing untuk melanjutkan pemrosesan dalam berbagai situasi. Misalnya, jika klien telah mematikan gerbang kontrol pemrosesan dengan KsGateTurnInputOff, panggil fungsi ini ketika siap untuk mencoba pemrosesan. Perhatikan bahwa ini hanya menyebabkan pengiriman pemrosesan jika gerbang kontrol proses dalam keadaan terbuka. Situasi lain melibatkan minidriver yang sebelumnya mengembalikan STATUS_PENDING ke pengiriman pemrosesan. Untuk detail selengkapnya, lihat Memulai Ulang Pemrosesan di AVStream dan Gerbang Kontrol Aliran di AVStream.

Pengiriman pemrosesan terjadi baik secara sinkron atau asinkron, dan hanya jika gerbang kontrol pemrosesan terbuka. Bendera Asinkron menentukan preferensi minidriver. Jika minidriver meminta pengiriman proses asinkron, pengiriman selalu asinkron. Namun, bahkan jika penelepon mengatur Asinkron ke FALSE, pengiriman sinkron hanya terjadi jika sistem saat ini berjalan pada IRQL kurang dari IRQL pemrosesan maksimum. Dengan kata lain, jika minidriver tidak menentukan pemrosesan tingkat pengiriman dan panggilan dilakukan di IRQL = DISPATCH_LEVEL, maka panggilan terjadi dalam item kerja asinkron di PASSIVE_LEVEL terlepas dari nilai Asinkron. Untuk informasi selengkapnya, lihat Pemrosesan Filter-Sentris dan Pemrosesan Pin-Sentris.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ks.h (termasuk Ks.h)
Pustaka Ks.lib
IRQL <=DISPATCH_LEVEL (Lihat Keterangan)

Lihat juga

KSFILTER_DISPATCH

KsFilterAttemptProcessing

KsGateCaptureThreshold