Condividi tramite

Interfaccia IAMOpenProgress (strmif.h)

  • Articolo

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

L'interfaccia IAMOpenProgress segnala lo stato di avanzamento di un'operazione di apertura file e consente all'applicazione di annullare l'operazione.

I filtri che aprono file in una rete possono esporre questa interfaccia. Un'applicazione può usarla per eseguire query sullo stato di avanzamento del download o per annullare il download. Se la rete non è reattiva, un metodo come IGraphBuilder::RenderFile potrebbe bloccare per un periodo indefinito. Per impedire al blocco dell'applicazione, creare un thread di lavoro che usa IAMOpenProgress per monitorare lo stato di avanzamento. Il thread di lavoro può annullare l'operazione se si verifica un timeout predefinito o in risposta a un comando dall'utente.

Il filtro Origine file (URL) supporta questa interfaccia.

Ereditarietà

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

Metodi

L'interfaccia IAMOpenProgress include questi metodi.

 
IAMOpenProgress::AbortOperation

Il metodo AbortOperation annulla l'operazione di apertura del file.
IAMOpenProgress::QueryProgress

Il metodo QueryProgress recupera lo stato di avanzamento dell'operazione di apertura file.

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)