Interfaccia IQueueCommand (control.h)

  • Articolo

[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 IQueueCommand accoda un comando per l'elaborazione in un momento designato. Filter Graph Manager espone questa interfaccia. Le applicazioni possono usarlo per accodare in anticipo i comandi graph-control.

I metodi in IQueueCommand vengono modellati dopo il metodo IDispatch::InvokeAt . L'applicazione specifica un'interfaccia, un metodo sull'interfaccia, i parametri per il metodo e un'ora di riferimento. Filter Graph Manager accoda queste informazioni e quindi richiama il metodo al momento specificato. L'interfaccia richiesta deve ereditare IDispatch e deve essere esposta da Filter Graph Manager. Gli esempi includono IMediaControl, IMediaEventEx e IMediaPosition.

Quando il comando viene accodato, il gestore del grafo dei filtri restituisce un puntatore all'interfaccia IDeferredCommand . L'applicazione può usare questa interfaccia per annullare o modificare il comando.

Nota I due metodi in IQueueCommand fanno riferimento rispettivamente all'ora di flusso e all'ora di presentazione. Nel contesto di Filter Graph Manager, l'ora del flusso e l'ora di presentazione sono identiche, quindi non esiste alcuna differenza funzionale tra i due metodi. Altri oggetti possono implementare IQueueCommand in modo diverso. Per altre informazioni sull'ora del flusso e sull'ora di presentazione, vedere Time and Clocks in DirectShow.
 

Ereditarietà

L'interfaccia IQueueCommand eredita dall'interfaccia IUnknown . IQueueCommand ha anche questi tipi di membri:

Metodi

L'interfaccia IQueueCommand include questi metodi.

 
IQueueCommand::InvokeAtPresentationTime

Il metodo InvokeAtPresentationTime accoda un metodo da richiamare all'ora di presentazione specificata.
IQueueCommand::InvokeAtStreamTime

Il metodo InvokeAtStreamTime accoda una modifica del metodo o della proprietà per l'esecuzione in un intervallo di tempo di flusso specificato, ovvero l'ora di presentazione rispetto all'offset temporale del flusso corrente.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione control.h (include Dshow.h)