Metodo COutputQueue.ReceiveMultiple

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

Il ReceiveMultiple metodo recapita un batch di campioni multimediali al pin di input.

Sintassi

HRESULT ReceiveMultiple(
   IMediaSample **ppSamples,
   long         nSamples,
   long         *nSamplesProcessed
);

Parametri

ppSamples

Indirizzo di un puntatore a una matrice di campioni.

nSamples

Numero di campioni nella matrice.

nSamplesProcessed

Puntatore a una variabile che riceve il numero di campioni recapitati correttamente.

Valore restituito

Restituisce un valore HRESULT . I valori possibili includono quelli illustrati nella tabella seguente.

Codice restituito Descrizione
S_FALSE
 Notifica di fine flusso ricevuta prima dell'elaborazione di questo esempio.
S_OK
 Operazione completata.

Commenti

Se l'oggetto usa un thread, questo metodo accoda tutti gli esempi passati nella matrice. In caso contrario, il metodo chiama il metodo IMemInputPin::ReceiveMultiple sul pin di input.

Requisiti

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

Vedi anche

Classe COutputQueue