IMediaSeeking::GetPositions-Methode (strmif.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 GetPositions -Methode ruft die aktuelle Position und die Stoppposition relativ zur Gesamtdauer des Datenstroms ab.
Syntax
HRESULT GetPositions(
[out] LONGLONG *pCurrent,
[out] LONGLONG *pStop
);
Parameter
[out] pCurrent
Zeiger auf eine Variable, die die aktuelle Position in Einheiten des aktuellen Zeitformats empfängt.
[out] pStop
Zeiger auf eine Variable, die die Stoppposition in Einheiten des aktuellen Zeitformats empfängt.
Rückgabewert
Gibt einen HRESULT-Wert zurück. Die folgenden Werte sind möglich.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Die -Methode wird nicht unterstützt. |
|
NULL-Zeigerargument. |
Hinweise
Die aktuelle Position und die Stoppposition sind sowohl relativ zum ursprünglichen Stream als auch unabhängig von der Wiedergaberate.
Die zurückgegebenen Werte werden 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 |