Interfaccia IAMStreamControl (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.
L'interfaccia IAMStreamControl controlla singoli flussi in un filtro. I pin su alcuni filtri espongono questa interfaccia. Ad esempio, il filtro AVI Mux supporta questa interfaccia sui pin di input e il filtro di acquisizione audio e il filtro di acquisizione video WDM supportano il filtro per l'acquisizione di dati nei pin di output.
Questa interfaccia consente a un'applicazione di attivare e disattivare i flussi in orari specificati. Ad esempio, un'applicazione potrebbe disattivare un flusso audio per disattivare l'audio durante l'anteprima video. Le applicazioni di acquisizione possono usare questa interfaccia per specificare orari di inizio e arresto precisi per l'acquisizione e per controllare i flussi di acquisizione e anteprima in modo indipendente tra loro.
Per usare questa interfaccia, chiamare il metodo IAMStreamControl::StartAt per specificare quando il pin inizierà a recapitare i dati e il metodo IAMStreamControl::StopAt per specificare quando interromperà la distribuzione dei dati. Chiamare quindi IMediaControl::Run in Filter Graph Manager per eseguire il grafico del filtro. Tutti i tempi sono relativi all'avvio del grafico.
Quando si usa questa interfaccia, tenere presente le limitazioni seguenti:
- Deve essere presente un orologio di riferimento nel grafico del filtro.
- I pin di anteprima sulle schede di acquisizione con sovrimpressione hardware non supportano questa interfaccia.
- Se si acquisiscono audio e video in un file AVI interleaved, il filtro AVI Mux richiede entrambi i flussi di dati. Se si arresta un flusso, il filtro non può interlevare i dati. Per altre informazioni, vedere Interfaccia IConfigInterleaving.
Filtrare gli sviluppatori: la classe di base CBaseStreamControl implementa questa interfaccia.
Ereditarietà
L'interfaccia IAMStreamControl eredita dall'interfaccia IUnknown . IAMStreamControl include anche questi tipi di membri:
Metodi
L'interfaccia IAMStreamControl include questi metodi.
| IAMStreamControl::GetInfo Il metodo GetInfo recupera informazioni sulle impostazioni correnti del controllo di flusso, inclusi gli orari di avvio e arresto. |
| IAMStreamControl::StartAt Il metodo StartAt informa il pin quando avviare la distribuzione dei dati. |
| IAMStreamControl::StopAt Il metodo StopAt informa il pin quando interrompere la distribuzione dei dati. |
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) |