CBaseInputPin.ReceiveMultiple-Methode

Die ReceiveMultiple Methode empfängt ein Array von Beispielen. Diese Methode implementiert die IMemInputPin::ReceiveMultiple-Methode .

Syntax

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

Parameter

pSamples

Adresse eines Arrays von IMediaSample-Zeigern , von Größe nSamples.

nSamples

Anzahl der zu verarbeitenden Beispiele.

nSamplesProcessed

Zeiger auf eine Variable, die die Anzahl der Beispiele empfängt, die verarbeitet wurden.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte umfassen die in der folgenden Tabelle aufgeführten Werte.

Rückgabecode Beschreibung
S_OK
Erfolg.
S_FALSE
Pin wird derzeit gespült; Das Beispiel wurde abgelehnt.
E_POINTER
NULL-Zeigerargument.
VFW_E_INVALIDMEDIATYPE
Ungültiger Medientyp.
VFW_E_RUNTIME_ERROR
Ein Laufzeitfehler wurde aufgetreten.
VFW_E_WRONG_STATE
Die Pin wird beendet.

Bemerkungen

Diese Methode verhält sich wie die CBaseInputPin::Receive-Methode , erhält jedoch ein Array von Beispielen. In der Basisklasse durchlaufen die Methode das Array und ruft "Empfangen " mit jedem Beispiel auf. Überschreiben Sie diese Funktion, wenn Ihr Filter Batches von Beispielen effizienter verarbeiten kann, als sie gleichzeitig zu verarbeiten.

Requirements (Anforderungen)

Anforderung Wert
Header
Amfilter.h (enthalten Streams.h)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Weitere Informationen

CBaseInputPin-Klasse