Interfaccia IAMFilterGraphCallback (strmif.h)

[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.

L'interfaccia IAMFilterGraphCallback fornisce un meccanismo di callback durante la compilazione del grafo.

Per usare questa interfaccia, implementare l'interfaccia nell'applicazione o nell'oggetto client. Eseguire una query su Filter Graph Manager per l'interfaccia IObjectWithSite e chiamare il metodo IObjectWithSite::SetSite con un puntatore all'implementazione dell'interfaccia. Durante la compilazione del grafo, se Filter Graph Manager non riesce a eseguire il rendering di un pin, chiama il metodo UnabletoRender . Il client può quindi eseguire un'azione appropriata, ad esempio fornire un messaggio di errore per l'utente o registrare un nuovo filtro.

Ereditarietà

L'interfaccia IAMFilterGraphCallback eredita dall'interfaccia IUnknown . IAMFilterGraphCallback include anche questi tipi di membri:

Metodi

L'interfaccia IAMFilterGraphCallback include questi metodi.

 
IAMFilterGraphCallback::UnableToRender

Il metodo UnableToRender viene chiamato da Filter Graph Manager se non riesce a trovare alcuna combinazione di filtri per eseguire il rendering del pin specificato.

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)

Vedi anche

Interfaccia IAMGraphBuilderCallback