Metodo IBaseFilter::FindPin (strmif.h)
[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 |
|---|---|
|
Operazione completata. |
|
Argomento puntatore NULL. |
|
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 |