IMediaPosition::get_PrerollTime-Methode (control.h)
[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 get_PrerollTime -Methode ruft die Datenmenge ab, die vor der Startposition in die Warteschlange eingereiht wird.
Syntax
HRESULT get_PrerollTime(
[out] REFTIME *pllTime
);
Parameter
[out] pllTime
Zeiger auf eine Variable, die die Prerollzeit in Sekunden empfängt.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Nicht implementiert. |
|
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.
Wenn kein Filter im Graphen diese Methode implementiert, legt der Filter Graph-Manager den Wert von *pllTime auf Null fest und gibt S_OK zurück.
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 | control.h (include Dshow.h) |
| Bibliothek | Strmiids.lib |