Metode CBasePin.AttemptConnection

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 AttemptConnection ini tersambung ke pin lain menggunakan jenis media tertentu.

Sintaks

virtual HRESULT AttemptConnection(
         IPin       *pReceivePin,
   const CMediaType *pmt
);

Parameter

pReceivePin: Arahkan ke antarmuka IPin pin penerima.
Pmt: Penunjuk ke objek CMediaType yang menentukan jenis media.

Nilai kembali

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

Menampilkan kode	Deskripsi
S_OK	Berhasil.
VFW_E_TYPE_NOT_ACCEPTED	Tipe media tidak dapat diterima.

Keterangan

Metode ini mencoba menghubungkan dua pin dengan jenis media tertentu. Jika jenis tidak dapat diterima, metode gagal tanpa mencoba jenis media lainnya.

Jika jenis media dapat diterima, metode ini memanggil metode IPin::ReceiveConnection pin penerima. Kemudian memanggil metode CBasePin::CompleteConnect untuk menyelesaikan koneksi.

Persyaratan

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

Lihat juga

Kelas CBasePin

Bagikan melalui