Classe CCmdQueue

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

La CCmdQueue classe è una classe base che fornisce una coda di oggetti CDeferredCommand e funzioni membro per aggiungere, rimuovere, controllare lo stato e richiamare i comandi in coda. Un CCmdQueue oggetto fa parte di un oggetto che implementa i metodi IQueueCommand . Gestione grafo filtri implementa i metodi IQueueCommand in modo che le applicazioni possano accodare i comandi al grafico dei filtri. I filtri che implementano l'interfaccia IQueueCommand usano direttamente questa classe. Se vuoi usare oggetti CDeferredCommand , la coda deve essere derivata da questa classe.

Esistono due modalità di sincronizzazione: grossolana e accurata. In modalità grossolana, l'applicazione attende fino all'arrivo di un orario specificato e quindi esegue il comando . In modalità accurata, l'applicazione attende l'inizio dell'elaborazione sull'esempio visualizzato al momento e quindi esegue il comando . Il filtro determina quale implementerà. Gestione grafici filtro implementa sempre la modalità grossolana per i comandi accodati in gestione del grafo dei filtri.

Se si vuole eseguire la sincronizzazione grossolana, è probabile che si voglia attendere il completamento di un comando e quindi eseguirlo. A tale scopo , chiamare CCmdQueue::GetDueCommand. Se sono presenti diversi aspetti da attendere, ottenere l'handle dell'evento da CCmdQueue::GetDueHandle e quindi chiamare CCmdQueue::GetDueCommand quando viene segnalato. il tempo di flusso avanza solo tra le chiamate alle funzioni membro CCmdQueue::Run e CCmdQueue::EndRun . Non esiste alcuna garanzia che, se l'handle è impostato, sarà disponibile un comando pronto. Ogni volta che l'evento viene segnalato, chiamare la funzione membro GetDueCommand (probabilmente con un timeout pari a zero); questo può restituire E_ABORT se non è pronto alcun comando.

Se si desidera una sincronizzazione accurata, chiamare la funzione membro CCmdQueue::GetCommandDueFor e passare gli esempi che si sta per elaborare come parametro. Verrà restituito quanto segue:

• Comando in fase di flusso dovuto o prima di tale ora di flusso.
• Comando in fase di presentazione dovuto o prima della presentazione dell'ora del flusso. Eseguire questa operazione solo tra le funzioni membro CCmdQueue::Run e CCmdQueue::EndRun , perché al di fuori di questo, il mapping dall'ora del flusso all'ora di presentazione non è noto.
• Qualsiasi comando in fase di presentazione è scaduto.

Se si desidera una sincronizzazione accurata per esempi che potrebbero essere elaborati durante la modalità sospesa, è necessario usare i comandi in fase di flusso.

In tutti i casi, i comandi rimangono in coda fino a quando non vengono chiamati o annullati. L'impostazione e la reimpostazione dell'handle di eventi vengono gestite interamente da questo oggetto coda.