Metodo CTransformFilter.FindPin

Articolo
07/28/2023

[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 metodo FindPin ottiene il pin con l'identificatore specificato. Questo metodo implementa il metodo IBaseFilter::FindPin .

Sintassi

HRESULT FindPin(
   LPCWSTR Id,
   IPin    **ppPin
);

Parametri

Id: Stringa di caratteri wide che contiene l'identificatore del pin.
ppPin: Riceve un puntatore all'interfaccia IPin del pin. Se il metodo ha esito negativo, *ppPin è impostato su NULL.

Valore restituito

Restituisce uno dei valori HRESULT illustrati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Operazione completata.
E_OUTOFMEMORY	Memoria insufficiente.
E_POINTER	Argomento puntatore NULL.
VFW_E_NOT_FOUND	Impossibile trovare un pin con questo identificatore.

Commenti

Importante

L'implementazione di questo metodo non chiama IPin::QueryId per trovare la corrispondenza con l'identificatore del pin. Il metodo presuppone invece che il pin di input sia denominato "In" e che il pin di output sia denominato "Out". Se si usa un set diverso di identificatori di pin, eseguire l'override di questo metodo.

Requisiti

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

Vedi anche

Classe CTransformFilter

Condividi tramite