Share via

COutputQueue::ReceiveMultiple

  • Article
 
Microsoft DirectShow 9.0

COutputQueue::ReceiveMultiple

The ReceiveMultiple method delivers a batch of media samples to the input pin.

Syntax

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

Parameters

ppSamples

Address of a pointer to an array of samples.

nSamples

Number of samples in the array.

nSamplesProcessed

Pointer to a variable that receives the number of samples delivered successfully.

Return Value

Returns an HRESULT value. Possible values include those shown in the following table.

Value Description
S_FALSE End-of-stream notification received before processing this sample.
S_OK Success.

Remarks

If the object is using a thread, this method queues all of the samples passed in the array. Otherwise, the method calls the IMemInputPin::ReceiveMultiple method on the input pin.

Requirements

**  Header:** Declared in Outputq.h; include Streams.h.

**  Library:** Use Strmbase.lib (retail builds) or Strmbasd.lib (debug builds).

See Also