Interfaccia IGraphBuilder (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.
Questa interfaccia fornisce metodi che consentono a un'applicazione di compilare un grafico di filtro. Filter Graph Manager implementa questa interfaccia.
L'interfaccia IGraphBuilder eredita dall'interfaccia IFilterGraph . IFilterGraph fornisce operazioni di base, ad esempio l'aggiunta di un filtro al grafico o la connessione di due pin. IGraphBuilder aggiunge altri metodi che costruiscono grafici da informazioni parziali. Ad esempio, il metodo IGraphBuilder::RenderFile compila un grafico per la riproduzione di file, in base al nome del file. Il metodo IGraphBuilder::Render esegue il rendering dei dati da un pin di output connettendo nuovi filtri al pin.
Usando questi metodi, un'applicazione non deve specificare ogni filtro e connessione pin nel grafico. Invece, Filter Graph Manager seleziona i filtri registrati nel sistema dell'utente, li aggiunge al grafico e li connette. Per altre informazioni, vedere Intelligent Connect.
Ereditarietà
L'interfaccia IGraphBuilder eredita da IFilterGraph. IGraphBuilder include anche questi tipi di membri:
Metodi
L'interfaccia IGraphBuilder include questi metodi.
| IGraphBuilder::Abort Il metodo Abort richiede a Filter Graph Manager di arrestare il più rapidamente possibile l'attività corrente. |
| IGraphBuilder::AddSourceFilter Il metodo AddSourceFilter aggiunge un filtro di origine per un file specificato al grafico del filtro. |
| IGraphBuilder::Connect Il metodo Connect connette i due pin, usando intermedi, se necessario. |
| IGraphBuilder::Render Il metodo Rendering compila un grafico di filtro che esegue il rendering dei dati da un pin di output specificato. |
| IGraphBuilder::RenderFile Il metodo RenderFile compila un grafico di filtro che esegue il rendering del file specificato. (IGraphBuilder.RenderFile) |
| IGraphBuilder::SetLogFile Il metodo SetLogFile imposta il file per le azioni di registrazione eseguite durante il tentativo di eseguire un'operazione. |
| IGraphBuilder::ShouldOperationContinue Il metodo ShouldOperationContinue esegue una query sul fatto che l'operazione corrente continui. |
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) |