Metodo IAMGraphBuilderCallback::SelectedFilter (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.
Filter Graph Manager chiama questo metodo quando trova un filtro candidato per il grafico, ma prima di creare il filtro.
Sintassi
HRESULT SelectedFilter(
IMoniker *pMon
);
Parametri
pMon
Puntatore a un moniker contenente informazioni sul filtro.
Valore restituito
Se il metodo restituisce un codice riuscito, Filter Graph Manager crea il filtro e prova a connetterlo. Se il metodo restituisce un codice di errore, Filter Graph Manager rifiuta il filtro.
Commenti
Questo metodo consente al client di esaminare un filtro per determinare se è accettabile per il grafico del filtro corrente.
Filter Graph Manager contiene una sezione critica a livello di grafico mentre chiama questo metodo. Pertanto, il metodo di callback deve evitare di chiamare qualsiasi metodo in Filter Graph Manager o qualsiasi metodo sui filtri che potrebbero modificare lo stato del grafico (ad esempio disconnettere i pin). In questo modo potrebbe causare un deadlock o altri comportamenti imprevisti.
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 |