Metodo IAMGraphBuilderCallback::CreateFilter (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 dopo aver creato un filtro, ma prima di tentare di connettere il filtro.
Sintassi
HRESULT CreatedFilter(
IBaseFilter *pFil
);
Parametri
pFil
Puntatore all'interfaccia IBaseFilter del filtro.
Valore restituito
Se il metodo restituisce un codice riuscito, Filter Graph Manager tenta di connettere il filtro. Se il metodo restituisce un codice di errore, Filter Graph Manager rifiuta il filtro.
Commenti
Questo metodo consente al client di configurare il filtro immediatamente dopo la creazione. Il renderer di mix video è l'esempio principale di un filtro che richiede la configurazione prima della connessione. La maggior parte degli altri filtri DirectShow può essere configurata dopo la connessione.
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
| Requisito | Valore |
|---|---|
| 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 |