Metode CBaseFilter.FindPin

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 FindPin mengambil pin dengan pengidentifikasi yang ditentukan. Metode ini mengimplementasikan metode IBaseFilter::FindPin .

Sintaks

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

Parameter

Id: Penunjuk ke string Unicode konstanta yang dihentikan null yang mengidentifikasi pin.
ppPin: Alamat variabel yang menerima penunjuk ke antarmuka IPin pin.

Mengembalikan nilai

Mengembalikan salah satu nilai HRESULT berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
E_POINTER	Argumen pointer NULL.
VFW_E_NOT_FOUND	Tidak dapat menemukan pin yang cocok.

Keterangan

Metode ini memanggil metode CBasePin::Name untuk membandingkan nama setiap pin dengan string yang ditentukan oleh parameter Id .

Jika metode berhasil, antarmuka IPin memiliki jumlah referensi yang luar biasa. Pastikan untuk merilisnya ketika Anda selesai.

Persyaratan

Persyaratan	Nilai
Header	Amfilter.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Kelas CBaseFilter

Bagikan melalui