Metodo CBasePin.GetConnected

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation. Queste funzionalità sono state ottimizzate per Windows 10 e Windows 11. Microsoft consiglia vivamente che il nuovo codice usi MediaPlayer, IMFMediaEngine e Audio/Video Capture in Media Foundation invece di DirectShow, quando possibile. Microsoft suggerisce che il codice esistente che usa le API legacy venga riscritto per usare le nuove API, se possibile.

Il GetConnected metodo recupera il pin connesso a questo pin.

Sintassi

IPin* GetConnected();

Parametri

Questo metodo non presenta parametri.

Valore restituito

Restituisce un puntatore all'interfaccia IPin dell'altro pin.

Commenti

Se il pin non è connesso, questo metodo restituisce NULL. Chiamare il metodo CBasePin::IsConnected per determinare se il pin è connesso.

Il metodo non chiama AddRef sull'interfaccia IPin , quindi il chiamante non deve rilasciare l'interfaccia.

Esempio

Poiché il conteggio dei riferimenti non viene incrementato sul puntatore restituito, è possibile concatenare le chiamate al metodo:

if (m_MyPin->IsConnected())
{
    m_MyPin->GetConnected()->EndOfStream();
}

Questo modello di codifica è molto pratico; ma come illustrato nell'esempio, è necessario prestare attenzione a non dereferenziare un puntatore NULL quando il pin non è connesso.

Requisiti

Requisito Valore
Intestazione
Amfilter.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe CBasePin