Antarmuka IKsInterfaceHandler (ksproxy.h)

Antarmuka IKsInterfaceHandler menyediakan metode yang sampel marshal ke dalam kernel berdasarkan struktur KSPIN_INTERFACE yang ditentukan untuk koneksi yang dibuat. IID untuk antarmuka ini IID_IKsInterfaceHandler.

Warisan

Antarmuka IKsInterfaceHandler mewarisi dari antarmuka IUnknown.

Metode

Antarmuka IKsInterfaceHandler memiliki metode ini.

IKsInterfaceHandler::KsCompleteIo Metode KsCompleteIo membersihkan header yang diperluas dan merilis sampel media setelah input dan output (I/O) selesai.
IKsInterfaceHandler::KsProcessMediaSamples Metode KsProcessMediaSamples memproses sampel media.
IKsInterfaceHandler::KsSetPin Metode KsSetPin menginformasikan handler antarmuka streaming tentang pin untuk berkomunikasi saat meneruskan data.

Komentar

Untuk menjaga proksi tetap netral sehubungan dengan antarmuka yang digunakan untuk mengalirkan data, penanganan antarmuka dimuat untuk menerjemahkan sampel media DirectShow ke dan dari driver tingkat kernel. Handler antarmuka mengimplementasikan metode antarmuka IKsInterfaceHandler untuk melakukan praproscesing dan pascaproscessing pada semua sampel media dan untuk menandakan penyelesaian input dan output (I/O).

Setiap handler antarmuka dapat melakukan marshal sampel media menggunakan metodenya sendiri. Handler antarmuka standar yang diterapkan proksi KS menggunakan IOCTL_KS_WRITE_STREAM untuk operasi penerimaan dan IOCTL_KS_READ_STREAM untuk operasi pengiriman, tetapi handler antarmuka kustom dapat menggunakan beberapa metode lain.

Saat pin tersambung, proksi menggunakan GUID di Set anggota struktur KSPIN_INTERFACE untuk menentukan penanganan antarmuka apa yang akan dimuat. Handler antarmuka terdaftar sebagai server COM di bawah kelas GUID tersebut. Handler antarmuka harus menangani semua variasi antarmuka dalam set antarmuka. Pin jembatan tidak diharapkan untuk mengalirkan data, dan penanganan antarmuka tidak dimuat untuk mereka.

Pada handler antarmuka buat permintaan melalui CoCreateInstance, server selalu disajikan luar IUnknown untuk membuat objek COM. IUnknown ini adalah antarmuka pada objek pin yang memuat handler antarmuka ini. Penunjuk antarmuka IUnknown dapat digunakan untuk mengkueri informasi atau antarmuka, seperti antarmuka IKsControl, dari pin, meskipun pin mode kernel mungkin belum dibuat pada saat handler antarmuka dimuat. Tidak ada referensi yang harus dibiarkan pada objek luar melalui memperoleh antarmuka apa pun, karena akan menghasilkan jumlah referensi melingkar. Menggunakan antarmuka tanpa jumlah referensi dapat diterima, karena objek luar memiliki handler dan, menurut definisi, dihancurkan ketika jumlah referensi objek luar mencapai nol.

Persyaratan

Syarat	Nilai
Platform Target	Windows
Header	ksproxy.h

Lihat juga

CoCreateInstance

IKsControl

KSPIN_INTERFACE