Antarmuka IKsInterfaceHandler (ksproxy.h)

Antarmuka IKsInterfaceHandler menyediakan metode yang marshal sampel 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 penangan antarmuka streaming tentang pin untuk berkomunikasi saat meneruskan data.

Keterangan

Untuk menjaga proksi tetap netral sehubungan dengan antarmuka yang digunakan untuk mengalirkan data, penangan antarmuka dimuat untuk menerjemahkan sampel media DirectShow ke dan dari driver tingkat kernel. Handler antarmuka mengimplementasikan metode antarmuka IKsInterfaceHandler untuk melakukan pra-pemrosesan dan pascaprosemsing 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 terima 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 handler 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 penangan antarmuka tidak dimuat untuk mereka.

Pada permintaan pembuatan handler antarmuka melalui CoCreateInstance, server selalu disajikan IUnknown luar 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

Persyaratan	Nilai
Target Platform	Windows
Header	ksproxy.h

Lihat juga

CoCreateInstance

IKsControl

KSPIN_INTERFACE