Metodo CTransInPlaceFilter.GetPin

[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 esegue l'override del metodo CTransformFilter::GetPin . 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 CTransInPlaceInputPin e CTransInPlaceOutputPin 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

Vedi anche

Classe CTransInPlaceFilter