Fungsi KsPinGetConnectedFilterInterface (ks.h)

Artikel
02/29/2024

Fungsi KsPinGetConnectedFilterInterFace meminta filter tempat Pin tersambung untuk mendapatkan penunjuk ke antarmuka COM.

Sintaks

KSDDKAPI NTSTATUS KsPinGetConnectedFilterInterface(
  [in]  PKSPIN     Pin,
  [in]  const GUID *InterfaceId,
  [out] PVOID      *Interface
);

Parameter

[in] Pin

Penunjuk ke struktur KSPIN . Filter tempat pin ini dilampirkan dikueri untuk antarmuka yang diminta.

[in] InterfaceId

Pointer ke GUID yang mewakili ID antarmuka untuk diperoleh antarmuka. Panggilan QueryInterface secara otomatis dilakukan untuk antarmuka ini.

[out] Interface

Pointer ke PVOID. Seperti dalam COM, penunjuk antarmuka yang dihasilkan disimpan ke dalam *Antarmuka. Antarmuka ini memiliki jumlah referensi yang sesuai dan harus dirilis oleh pemanggil seperti dalam COM.

Nilai kembali

KsPinGetConnectedFilterInterface mengembalikan STATUS_SUCCESS jika antarmuka ada pada filter yang tersambung atau di thunk AVStream. Jika STATUS_SUCCESS dikembalikan, penunjuk antarmuka disetorkan ke *Antarmuka. Jika tidak, ia mengembalikan STATUS_NOINTERFACE. Perhatikan bahwa ini sesuai dengan E_NOINTERFACE COM HRESULT.

Keterangan

Secara default, objek mendukung antarmuka IUnknown dan antarmuka IKsControl . Jika filter dan pin yang tersambung adalah objek AVStream, kueri dan penunjuk antarmuka yang dikembalikan adalah panggilan langsung ke driver lain. Namun, jika pin dan filter yang terhubung bukan milik driver AVStream, thunk dibuat yang menyediakan dukungan IKsControl melalui panggilan sinkron ke driver yang berisi filter, menggunakan IoCallDriver.

Penggunaan KsPinGetConnectedFilterInterFace yang paling umum adalah memperoleh antarmuka kontrol untuk filter yang dilampirkan Pin . Antarmuka kontrol ini kemudian dapat digunakan untuk panggilan properti, metode, atau peristiwa ke pin yang terhubung, atau dapat mengkueri antarmuka yang telah diagregasi ke filter yang tersambung. (Jika filter yang tersambung adalah filter AVStream; AVStream menyediakan pengintaian hanya untuk IKsControl dan IUnknown untuk filter non-AVStream).

Thunk dibuat hanya jika Pin adalah pin sumber; dengan demikian, panggilan hanya berfungsi jika satu atau beberapa hal berikut ini benar:

Koneksinya adalah intra-AVStream (Pin yang terhubung dengan Pin adalah pin AVStream).
Pin adalah pin sumber.

Jika tidak, STATUS_UNSUCCESSFUL dikembalikan.

Persyaratan

Persyaratan	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.
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib
IRQL	PASSIVE_LEVEL