Metodo CSource.FindPin

  • 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 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