Fungsi panggilan balik PFNKSPIN (ks.h)
Rutinitas panggilan balik AVStream minidriver dipanggil saat:
- Ada data yang tersedia untuk struktur KSPIN untuk diproses. Gunakan rutinitas ini untuk melakukan PemrosesanPin-Centric .
- KSPIN yang relevan berfungsi sebagai pin sink dan terhubung ke pin sumber AVStream.
Sintaksis
PFNKSPIN Pfnkspin;
NTSTATUS Pfnkspin(
[in] PKSPIN Pin
)
{...}
Parameter
[in] Pin
Arahkan ke KSPIN yang memiliki data bingkai yang tersedia untuk diproses.
Mengembalikan nilai
Kembalikan STATUS_SUCCESS untuk melanjutkan pemrosesan. Kembalikan STATUS_PENDING untuk berhenti memproses hingga peristiwa pemicu berikutnya.
Komentar
Tentang AVStrMiniPinProcess
Minidriver menentukan alamat rutin ini dalam Proses anggota struktur KSPIN_DISPATCH.
Tunjukkan bahwa filter menggunakan PemrosesanPin-Centric dengan menyediakan fungsi pengiriman ini. Minidriver mengatur bendera pin dalam struktur KSPIN_DESCRIPTOR_EX relevan yang menentukan kapan AVStream memanggil AVStrMiniPinProcess. Jika minidriver tidak menetapkan bendera dalam deskriptor, perilaku defaultnya adalah AVStream memanggil AVStrMiniPinProcess ketika data baru masuk ke antrean yang sebelumnya kosong. Lihat pemrosesan Pin-Centric untuk detail selengkapnya tentang pemrosesan pemicu.
Setelah diproses, minidriver dapat mencegah bingkai diselesaikan dengan mengkloning penunjuk aliran tepi terkemuka. Untuk melakukan ini, panggil KsStreamPointerClone. Lihat Penunjuk Aliran Edge Terkemuka 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 = PASSIVE_LEVEL default, atau mungkin pada DISPATCH_LEVEL jika minidriver telah menentukan KSPIN_FLAG_DISPATCH_LEVEL_PROCESSING di KSPIN_DESCRIPTOR_EXyang relevan.
Rutinitas ini bersifat opsional.
Tentang AVStrMiniPinConnect
Minidriver menentukan alamat rutin ini di Connect anggota struktur KSPIN_DISPATCH.
Mengembalikan STATUS_SUCCESS atau kesalahan yang dikembalikan dari upaya untuk membuat koneksi intra. Jangan kembali STATUS_PENDING.
Rutinitas ini bersifat opsional.
Persyaratan
| Syarat | 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. |
| Platform Target | Desktop |
| Header | ks.h (termasuk Ks.h) |
| IRQL | (Lihat bagian Komentar) |
Lihat juga
PemrosesanFilter-Centric
PemrosesanPin-Centric