Metodo IBaseFilter::FindPin (strmif.h)

  • Articolo

[La funzionalità associata a questa pagina, DirectShow, è una funzionalità legacy. È stata sostituita da MediaPlayer, FMMediaEngine 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, FMMediaEngine e Audio/Video Capture in Media Foundation anziché 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.

Sintassi

HRESULT FindPin(
  [in]  LPCWSTR Id,
  [out] IPin    **ppPin
);

Parametri

[in] Id

Puntatore a una stringa di caratteri wide costante che identifica il pin. Chiamare il metodo IPin::QueryId per recuperare l'identificatore di un pin.

[out] ppPin

Indirizzo di una variabile che riceve un puntatore all'interfaccia IPin del pin. Se il metodo ha esito negativo, *ppPin è impostato su NULL.

Valore restituito

Restituisce un valore HRESULT . Di seguito sono indicati alcuni valori possibili.

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

Commenti

Questo metodo supporta la persistenza del grafico. Usare il metodo IPin::QueryId per salvare lo stato di un pin e usare questo metodo per ripristinare lo stato. La stringa di identificatore del pin è definita dall'implementazione del filtro. L'identificatore deve essere univoco all'interno del filtro.

Se il metodo ha esito positivo, l'interfaccia IPin restituita ha un numero di riferimenti in sospeso. Assicurarsi di rilasciare l'interfaccia al termine.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione strmif.h (include Dshow.h)
Libreria Strmiids.lib

Vedi anche

Codici errore e esito positivo

Interfaccia IBaseFilter