Metodo CBaseFilter.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 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

Condividi tramite