CTransformFilter.Receive-Methode

Die Receive -Methode empfängt ein Medienbeispiel, verarbeitet es und übergibt ein Ausgabebeispiel an den Downstreamfilter.

Syntax

HRESULT Receive(
   IMediaSample *pSample
);

Parameter

pSample

Zeiger auf die IMediaSample-Schnittstelle im Eingabebeispiel.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Folgende Werte sind möglich:

Rückgabecode Beschreibung
S _ FALSE
Der Upstreamfilter sollte das Senden von Beispielen beenden.
S _ OK
Erfolg.

Hinweise

Der Eingabepin des Filters ruft diese Methode auf, wenn er ein Beispiel empfängt. Diese Methode ruft die CTransformFilter::InitializeOutputSample-Methode auf, die ein neues Ausgabebeispiel vorbereitet. Anschließend wird die CTransformFilter::Transform-Methode aufgerufen, die von der abgeleiteten Klasse implementiert werden muss. Die Transform-Methode verarbeitet die Eingabedaten und erzeugt Ausgabedaten.

Wenn die Transform-Methode S _ FALSE zurückgibt, Receive löscht die Methode dieses Beispiel. Im ersten gelöschten Beispiel sendet der Filter ein EC _ QUALITY _ CHANGE-Ereignis an den Filterdiagramm-Manager. Andernfalls liefert der Filter das Ausgabebeispiel, wenn die Transform-Methode S _ OK zurückgibt. Dazu ruft sie die IMemInputPin::Receive-Methode auf dem Nach-Eingabepin auf.

Anforderungen

Anforderung Wert
Header
Transfrm.h (include Streams.h)
Bibliothek
Strmbase.lib (Einzelhandels-Builds);
Strmbasd.lib (Debugbuilds)

Weitere Informationen

CTransformFilter-Klasse