IMediaSeeking::GetPreroll-Methode (strmif.h)

  • Artikel

[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 GetPreroll -Methode ruft die Datenmenge ab, die vor der Startposition in die Warteschlange eingereiht wird.

Syntax

HRESULT GetPreroll(
  [out] LONGLONG *pllPreroll
);

Parameter

[out] pllPreroll

Zeiger auf eine Variable, die die Vorrollzeit in Einheiten des aktuellen Zeitformats empfängt.

Rückgabewert

Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.

Rückgabecode BESCHREIBUNG
S_OK
 Erfolg.
E_NOTIMPL
 Die -Methode wird nicht unterstützt.
E_POINTER
 NULL-Zeigerargument.

Hinweise

Die Vorregistrierung ist die Zeit vor der Startposition, an der geräteunabhängiger Zugriff, z. B. Bandplayer, mit dem Rollrollen beginnen sollen.

Der zurückgegebene Wert wird im aktuellen Zeitformat ausgedrückt. Das Standardzeitformat ist REFERENCE_TIME Einheiten (100 Nanosekunden). Verwenden Sie zum Ändern von Zeitformaten die IMediaSeeking::SetTimeFormat-Methode .

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile strmif.h (include Dshow.h)
Bibliothek Strmiids.lib

Weitere Informationen

Fehler- und Erfolgscodes

IMediaSeeking-Schnittstelle