Metode ICaptureGraphBuilder2::FindPin (strmif.h)

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Metode ini FindPin mengambil pin tertentu pada filter, atau menentukan apakah pin tertentu cocok dengan kriteria yang ditentukan.

Sintaks

HRESULT FindPin(
  [in]  IUnknown      *pSource,
  [in]  PIN_DIRECTION pindir,
  [in]  const GUID    *pCategory,
  [in]  const GUID    *pType,
  [in]  BOOL          fUnconnected,
  [in]  int           num,
  [out] IPin          **ppPin
);

Parameter

[in] pSource

Arahkan ke antarmuka pada filter, atau ke antarmuka pada pin.

[in] pindir

Anggota enumerasi PIN_DIRECTION yang menentukan arah pin (input atau output).

[in] pCategory

Penunjuk ke GUID yang menentukan salah satu kategori pin yang tercantum dalam Sematkan Kumpulan Properti. Untuk mencocokkan pin apa pun, terlepas dari kategorinya, atur parameter ini ke NULL.

[in] pType

Penunjuk ke GUID tipe utama yang menentukan jenis media. Gunakan NULL untuk mencocokkan tipe media apa pun.

[in] fUnconnected

Nilai Boolean yang menentukan apakah pin harus tidak tersambung. Jika TRUE, pin harus tidak tersambung. Jika FALSE, pin dapat disambungkan atau tidak tersambung.

[in] num

Indeks pin berbasis nol untuk diambil, dari kumpulan pin yang cocok. Jika pSource adalah penunjuk ke filter, dan lebih dari satu pin cocok dengan kriteria pencarian, parameter ini menentukan pin mana yang akan diambil. Jika pSource adalah penunjuk ke pin, parameter ini diabaikan.

[out] ppPin

Alamat pointer untuk menerima antarmuka IPin dari pin yang cocok.

Mengembalikan nilai

Mengembalikan S_OK jika pin yang cocok ditemukan, atau E_FAIL sebaliknya.

Keterangan

Jika pSource adalah penunjuk ke filter, metode mencari pin nth pada filter yang cocok dengan kriteria pencarian, di mana n diberikan oleh parameter num . Jika metode menemukan pin yang cocok, metode mengembalikan penunjuk ke pin dalam parameter ppPin .

Jika pSource adalah penunjuk ke pin, metode menguji yang menyematkan terhadap kriteria pencarian. Jika pin cocok dengan kriteria, metode mengembalikan S_OK, dan mengembalikan penunjuk ke antarmuka IPin pin dalam parameter ppPin . Jika tidak, ia mengembalikan E_FAIL.

Dalam kedua kasus, jika metode berhasil, antarmuka IPin yang dikembalikan dalam parameter ppPin memiliki jumlah referensi yang luar biasa. Pastikan untuk merilis antarmuka saat Anda selesai menggunakannya.

Biasanya, aplikasi tidak perlu menggunakan metode ini. Ini disediakan untuk tugas yang sangat kompleks, ketika metode ICaptureGraphBuilder2::RenderStream tidak dapat membangun grafik filter. Gunakan metode ini untuk mengambil pin yang diinginkan dari filter pengambilan, lalu buat grafik lainnya secara manual.

Persyaratan


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	strmif.h (termasuk Dshow.h)
Pustaka	Strmiids.lib

Lihat juga

Kode Kesalahan dan Keberhasilan

Antarmuka ICaptureGraphBuilder2

Bagikan melalui