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 |
|---|---|
|
Der Upstreamfilter sollte das Senden von Beispielen beenden. |
|
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 |
|
| Bibliothek |
|