Metodo COutputQueue.ReceiveMultiple

Articolo
07/28/2023

[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

Condividi tramite