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

Sintassi

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

Parametri

Id: Puntatore a una stringa con terminazione Null che identifica il 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_POINTER	Argomento puntatore NULL.
VFW_E_NOT_FOUND	Impossibile trovare un pin con questo identificatore.

Commenti

Il primo pin è sempre denominato "1"; il secondo pin è denominato "2"; e così via. Per altre informazioni, vedere CSourceStream::QueryId.

Requisiti

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

Vedi anche

Classe CSource

Condividi tramite