Fungsi panggilan balik PFNKSPIN (ks.h)
Rutinitas panggilan balik AVStream minidriver dipanggil ketika:
- Ada data yang tersedia untuk diproses oleh struktur KSPIN . Gunakan rutinitas ini untuk melakukan Pemrosesan Pin-Sentris.
- KSPIN yang relevan berfungsi sebagai pin sink dan terhubung ke pin sumber AVStream.
Sintaks
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parameter
[in] Pin
Arahkan ke KSPIN yang memiliki data bingkai yang tersedia untuk diproses.
Nilai kembali
Kembalikan STATUS_SUCCESS untuk melanjutkan pemrosesan. Kembalikan STATUS_PENDING untuk menghentikan pemrosesan hingga peristiwa pemicu berikutnya.
Keterangan
Tentang AVStrMiniPinProcess
Minidriver menentukan alamat rutin ini dalam anggota Proses dari struktur KSPIN_DISPATCH-nya .
Tunjukkan bahwa filter menggunakan Pemrosesan Pin-Sentris dengan menyediakan fungsi pengiriman ini. Minidriver mengatur bendera pin dalam struktur KSPIN_DESCRIPTOR_EX yang relevan yang menentukan kapan AVStream memanggil AVStrMiniPinProcess. Jika minidriver tidak menetapkan bendera dalam deskriptor, perilaku defaultnya adalah AVStream memanggil AVStrMiniPinProcess saat data baru masuk ke antrean yang sebelumnya kosong. Lihat pemrosesan Pin-Centric untuk detail selengkapnya tentang pemrosesan pemicu.
Setelah diproses, minidriver dapat mencegah bingkai selesai dengan mengkloning penunjuk aliran tepi terkemuka. Untuk melakukan ini, panggil KsStreamPointerClone. Lihat Penunjuk Stream Tepi Depan dan Berikutnya.
Atau, tentukan tepi trailing yang berbeda dengan mengatur KSPIN_FLAG_DISTINCT_TRAILING_EDGE pada KSPIN_DESCRIPTOR_EX. Opsi ketiga adalah tidak memajukan penunjuk aliran tepi terkemuka.
Pengiriman proses dibuat pada IRQL default = PASSIVE_LEVEL, atau mungkin pada DISPATCH_LEVEL jika minidriver telah menentukan KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING dalam KSPIN_DESCRIPTOR_EX yang relevan.
Rutinitas ini bersifat opsional.
Tentang AVStrMiniPinConnect
Minidriver menentukan alamat rutin ini di anggota Connect dari struktur KSPIN_DISPATCH-nya .
Mengembalikan STATUS_SUCCESS atau kesalahan yang dikembalikan dari upaya untuk membuat koneksi intra. Jangan kembali STATUS_PENDING.
Rutinitas ini bersifat opsional.
Lihat juga Pin KS.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru serta DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Desktop |
| Header | ks.h (termasuk Ks.h) |
| IRQL | (Lihat bagian Keterangan) |