Metodo CTransformFilter.GetPin

  • 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 GetPin metodo recupera un pin.

Sintassi

virtual CBasePin* GetPin(
   int n
);

Parametri

n

Numero del pin specificato, indicizzato da zero. In questo filtro, il pin 0 è il pin di input e il pin 1 è il pin di output.

Valore restituito

Restituisce un puntatore all'oggetto CBasePin che implementa il pin oppure NULL se il metodo ha esito negativo.

Commenti

Questo metodo implementa il metodo CBaseFilter::GetPin virtuale puro. La prima volta che viene chiamato il metodo, crea entrambi i pin.

Questo metodo non incrementa il conteggio dei riferimenti sul pin restituito, pertanto il pin restituito non dispone di un conteggio dei riferimenti in sospeso. Se il chiamante deve mantenere un riferimento sul pin, deve chiamare il metodo IUnknown::AddRef sul pin.

Se il filtro usa i pin CTransformInputPin e CTransformOutputPin predefiniti, probabilmente non è necessario eseguire l'override di questo metodo. Se il filtro usa pin che estendono tali classi, tuttavia, è necessario eseguire l'override di questo metodo per creare pin di tale tipo.

Requisiti

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

Vedi anche

Classe CTransformFilter