Metode CBasePin.Connect

[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 Connect menyambungkan pin ke pin lain. Metode ini mengimplementasikan metode IPin::Connect .

Sintaks

HRESULT Connect(
         IPin          *pReceivePin,
   const AM_MEDIA_TYPE *pmt
);

Parameter

pReceivePin

Arahkan ke antarmuka IPin pin penerima.

Pmt

Penunjuk ke struktur AM_MEDIA_TYPE yang menentukan jenis media untuk koneksi.

Nilai kembali

Mengembalikan nilai HRESULT . Nilai yang mungkin termasuk yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Berhasil.
VFW_E_ALREADY_CONNECTED	Pin sudah tersambung.
VFW_E_NO_ACCEPTABLE_TYPES	Tidak dapat menemukan tipe media yang dapat diterima.
VFW_E_NOT_STOPPED	Filter aktif dan pin tidak mendukung koneksi ulang dinamis.
VFW_E_TYPE_NOT_ACCEPTED	Tipe media yang ditentukan tidak dapat diterima.

Keterangan

Parameter pmt bisa NULL. Ini juga dapat menentukan jenis media parsial, dengan nilai GUID_NULL untuk jenis utama, subjenis, atau format.

Di kelas dasar, metode ini menguji apakah pin sudah tersambung dan apakah filter dihentikan. Ini mendelegasikan sisa proses koneksi ke metode CBasePin::AgreeMediaType .

Persyaratan

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

Lihat juga

Kelas CBasePin