Metodo CBaseFilter.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 Unicode con terminazione Null costante che identifica il pin.

ppPin

Indirizzo di una variabile che riceve un puntatore all'interfaccia IPin del pin.

Valore restituito

Restituisce uno dei valori HRESULT seguenti.

Codice restituito Descrizione
S_OK
 Operazione completata.
E_POINTER
 Argomento puntatore NULL.
VFW_E_NOT_FOUND
 Impossibile trovare un pin corrispondente.

Commenti

Questo metodo chiama il metodo CBasePin::Name per confrontare il nome di ogni pin con la stringa specificata dal parametro Id .

Se il metodo ha esito positivo, l'interfaccia IPin ha un conteggio dei riferimenti in sospeso. Al termine, assicurarsi di rilasciarlo.

Requisiti

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

Vedi anche

Classe CBaseFilter