Freigeben über


CBaseRenderer.Render-Methode

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde von MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation abgelöst. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code mediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet, wenn möglich. Microsoft schlägt vor, dass vorhandener Code, der die Legacy-APIs verwendet, so umgeschrieben wird, dass nach Möglichkeit die neuen APIs verwendet werden.]

Die Render -Methode rendert ein Beispiel.

Syntax

virtual Render(
   IMediaSample *pMediaSample
);

Parameter

pMediaSample

Zeiger auf die IMediaSample-Schnittstelle des Beispiels.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Mögliche Werte sind die werte in der folgenden Tabelle.

Rückgabecode Beschreibung
S_FALSE
Der Filter wird beendet, oder pMediaSample ist NULL.
S_OK
Erfolg.

Bemerkungen

Diese Methode ruft die reine virtuelle Methode CBaseRenderer::D oRenderSample auf, die die eigentliche Arbeit erledigt. Die abgeleitete Klasse muss DoRenderSample implementieren.

Unmittelbar vor dem Aufrufen von DoRenderSample ruft diese Methode die CBaseRenderer::OnRenderStart-Methode auf. Unmittelbar danach wird die CBaseRenderer::OnRenderEnd-Methode aufgerufen. Die abgeleitete Klasse kann diese beiden Methoden bei Bedarf außer Kraft setzen.

Anforderungen

Anforderung Wert
Header
Renbase.h (streams.h einschließen)
Bibliothek
Strmbase.lib (Einzelhandelsbuilds);
Strmbasd.lib (Debugbuilds)

Siehe auch

CBaseRenderer-Klasse