Metode CBasePin.GetConnected
[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Tangkapan 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 Audio/Video Capture 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 mengambil GetConnected pin yang terhubung ke pin ini.
Sintaks
IPin* GetConnected();
Parameter
Metode ini tidak memiliki parameter.
Mengembalikan nilai
Mengembalikan penunjuk ke antarmuka IPin pin lainnya.
Keterangan
Jika pin tidak tersambung, metode ini mengembalikan NULL. Panggil metode CBasePin::IsConnected untuk menentukan apakah pin tersambung.
Metode ini tidak memanggil AddRef pada antarmuka IPin , sehingga pemanggil tidak boleh merilis antarmuka.
Contoh
Karena jumlah referensi tidak bertambah pada penunjuk yang dikembalikan, Anda dapat menautkan panggilan metode bersama-sama:
if (m_MyPin->IsConnected())
{
m_MyPin->GetConnected()->EndOfStream();
}
Pola pengkodian ini sangat nyaman; tetapi seperti yang ditunjukkan contoh, Anda harus berhati-hati untuk tidak mendereferensikan penunjuk NULL saat pin tidak tersambung.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Header |
|
| Pustaka |
|