CBaseFilter.StreamTime-Methode

  • Artikel

[Das dieser Seite zugeordnete Feature DirectShow ist ein Legacyfeature. Es wurde durch MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation ersetzt. Diese Features wurden für Windows 10 und Windows 11 optimiert. Microsoft empfiehlt dringend, dass neuer Code nach Möglichkeit MediaPlayer, IMFMediaEngine und Audio/Video Capture in Media Foundation anstelle von DirectShow verwendet. Microsoft schlägt vor, vorhandenen Code, der die Legacy-APIs verwendet, um nach Möglichkeit die neuen APIs zu verwenden.]

Die StreamTime-Methode ruft die aktuelle Streamzeit ab.

Syntax

virtual HRESULT StreamTime(
  [ref] CRefTime &rtStream
);

Parameter

rtStream [ref]

Verweis auf ein CRefTime-Objekt , das die aktuelle Streamzeit empfängt.

Rückgabewert

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

Rückgabecode Beschreibung
S_OK
 Erfolg.
VFW_E_NO_CLOCK
 Es ist keine Referenzuhr verfügbar.

Bemerkungen

Die Streamzeit wird als aktuelle Referenzzeit (wie von der Referenzuhr angegeben) abzüglich der Startzeit (angegeben durch CBaseFilter::m_tStart) definiert. Der Zeitstempel eines Medienbeispiels gibt die Streamzeit an, zu der er gerendert werden soll. Wenn ein Beispiel mit einem Zeitstempel unter der aktuellen Streamzeit noch nicht gerendert wurde, ist es verspätet.

Diese Methode ruft die Streamzeit ab, indem sie IReferenceClock::GetTime aufruft, um die aktuelle Referenzzeit abzurufen, und dann die anfängliche Startzeit subtrahiert.

Anforderungen

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

Siehe auch

Zeit und Uhren in DirectShow

CBaseFilter-Klasse