Freigeben über


CBaseRenderer.ShouldDrawSampleNow-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 ShouldDrawSampleNow -Methode bestimmt, wie ein Beispiel für das Rendern geplant wird.

Syntax

virtual HRESULT ShouldDrawSampleNow(
   IMediaSample   *pMediaSample,
   REFERENCE_TIME *pStartTime,
   REFERENCE_TIME *pEndTime
);

Parameter

pMediaSample

Zeiger auf die IMediaSample-Schnittstelle des Beispiels.

pStartTime

Zeiger auf eine Variable, die die Startzeit des Beispiels enthält.

pEndTime

Zeiger auf eine Variable, die die Endzeit des Beispiels enthält.

Rückgabewert

Gibt S_FALSE zurück. Wenn die abgeleitete Klasse diese Methode überschreibt, geben Sie einen der in der folgenden Tabelle gezeigten Werte zurück.

Rückgabecode BESCHREIBUNG
S_OK
Das Beispiel sollte sofort gerendert werden.
S_FALSE
Das Beispiel sollte basierend auf den Zeitstempeln für das Rendern geplant werden.
Fehlercode
Rendern Sie dieses Beispiel nicht.

Bemerkungen

Die CBaseRenderer::GetSampleTimes-Methode ruft diese Methode auf. Standardmäßig werden Beispiele für das Rendern immer basierend auf ihren Zeitstempeln geplant. Die abgeleitete Klasse kann diese Methode außer Kraft setzen. beispielsweise, um die Qualitätskontrolle zu implementieren.

Anforderungen

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

Siehe auch

CBaseRenderer-Klasse