CBaseInputPin::ReceiveMultiple

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

Retrieves the next block of data from the stream.

This method behaves much like the IMemInputPin::Receive method, but it works with multiple samples.

Override this function if you can usefully process samples in batches.

Syntax

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

Parameters

• pSamples
  Pointer to an array of samples.

• nSamples
  Number of samples to process.

• nSamplesProcessed
  Number of samples processed.

Return Value

Returns an HRESULT value.

Remarks

This member function implements the IMemInputPin::ReceiveMultiple method. It is implemented to call the CBaseInputPin::Receive member function in a loop for nSamples number of iterations.

Requirements