Classe COutputQueue

coutputqueue

La COutputQueue classe implementa una coda per distribuire esempi multimediali.

Questa classe consente a un pin di output di fornire esempi in modo asincrono. Gli esempi vengono inseriti in una coda e un thread di lavoro li recapita al pin di input. La coda può anche contenere messaggi di controllo che indicano un nuovo segmento, una notifica end-of-stream o un'operazione di scaricamento.

Per usare questa classe, creare un oggetto COutputQueue per ogni pin di output nel filtro. Nel metodo del costruttore specificare il pin di input connesso al pin di output. Usando questa classe, il pin di output non chiama i metodi direttamente nel pin di input. Chiama invece i metodi corrispondenti in COutputQueue, come illustrato nella tabella seguente.

Metodo Pin Metodo COutputQueue
IPin::BeginFlush BeginFlush
IPin::EndFlush EndFlush
IPin::EndOfStream EOS
IPin::NewSegment NewSegment
IMemInputPin::Receive Ricevere
IMemInputPin::ReceiveMultiple ReceiveMultiple

Facoltativamente, è possibile configurare l'oggetto COutputQueue per distribuire esempi in modo sincrono, senza un thread di lavoro. L'oggetto può anche decidere in fase di esecuzione se usare un thread di lavoro, in base alle caratteristiche del pin di input. Per altre informazioni, vedere COutputQueue::COutputQueue.

Variabili membro protette Descrizione
m_pPin Puntatore all'interfaccia IPin del pin di input.
m_pInputPin Puntatore all'interfaccia IMemInputPin del pin di input.
m_bBatchExact Contrassegno che specifica se l'oggetto fornisce esempi in batch esatti.
m_lBatchSize Dimensioni batch.
m_List Coda di esempio multimediale.
m_hSem Gestire un semaforo, usato dal thread per attendere gli esempi.
m_evFlushComplete Evento che segnala al termine di un'operazione di scaricamento.
m_hThread Gestire il thread di lavoro.
m_ppSamples Matrice di esempi di dimensioni COutputQueue::m_lBatchSize.
m_nBatched Numero di campioni attualmente in batch e in attesa di elaborazione.
m_lWaiting Contrassegno con valore diverso da zero quando il thread è in attesa di un esempio.
m_bFlushing Flag che specifica se l'oggetto esegue un'operazione di scaricamento.
m_bTerminate Flag che specifica se il thread deve terminare.
m_bSendAnyway Contrassegnare l'override dell'elaborazione batch.
m_hr Valore HRESULT che indica se l'oggetto accetterà esempi.
m_hEventPop Evento segnalato ogni volta che l'oggetto rimuove un esempio dalla coda.
Metodi protetti Descrizione
InitialThreadProc Chiama il metodo COutputQueue::ThreadProc quando viene creato il thread.
Threadproc Recupera esempi dalla coda e li recapita al pin di input.
IsQueued Determina se l'oggetto usa un thread di lavoro per fornire esempi.
QueueSample Accoda un esempio multimediale o un messaggio di controllo.
IsSpecialSample Determina se i dati in coda sono un messaggio di controllo.
FreeSamples Libera tutti gli esempi in sospeso.
NotificaThread Notifica al thread che la coda contiene dati.
Metodi pubblici Descrizione
COutputQueue Metodo costruttore.
~COutputQueue Metodo distruttore.
BeginFlush Avvia un'operazione di scaricamento.
EndFlush Termina un'operazione di scaricamento.
EOS Recapita una chiamata end-of-stream al pin di input.
SendAnyway Fornisce tutti gli esempi in sospeso.
NewSegment Recapita un nuovo segmento al pin di input.
Ricevere Fornisce un esempio multimediale al pin di input.
ReceiveMultiple Distribuisce un batch di campioni multimediali al pin di input.
Reimpostare Reimposta l'oggetto in modo che possa ricevere più dati.
IsIdle Determina se l'oggetto è in attesa di dati.
SetPopEvent Specifica un evento segnalato ogni volta che l'oggetto rimuove un esempio dalla coda.

Requisiti

Requisito Valore
Intestazione
Outputq.h (includere Flussi.h)
Libreria
Strmbase.lib (build al dettaglio);
Strmbasd.lib (build di debug)