Metodo COutputQueue.QueueSample

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

Il QueueSample metodo accoda un esempio.

Sintassi

void QueueSample(
   IMediaSample *pSample
);

Parametri

pSample

Puntatore all'interfaccia IMediaSample dell'esempio.

Valore restituito

Questo metodo non restituisce valori.

Commenti

Questo metodo aggiunge un esempio alla parte finale della coda. Tenere premuta la sezione critica prima di chiamare questo metodo e chiamarla solo quando l'oggetto usa un thread per recapitare campioni. Per determinare se l'oggetto usa un thread, chiamare il metodo COutputQueue::IsQueued .

Questo metodo può essere usato anche per inserire i messaggi di controllo nella coda. Un messaggio di controllo è una costante definita (cast a un tipo di LONG_PTR) che indica al thread di eseguire un'azione. La classe COutputQueue definisce i messaggi di controllo illustrati nella tabella seguente.

Etichetta Valore
Message Azione
EOS_PACKET Recapitare una notifica end-of-stream.
NEW_SEGMENT Distribuire un nuovo segmento.
RESET_PACKET Reimpostare lo stato della coda.
SEND_PACKET Inviare un batch parziale di campioni.

Si tratta di un metodo protetto, usato internamente dalla classe COutputQueue .

Requisiti

Requisito Valore
Intestazione
Outputq.h (include Streams.h)
Libreria
Strmbase.lib (build retail);
Strmbasd.lib (build di debug)

Vedi anche

Classe COutputQueue