Freigeben über


IMediaPosition-Schnittstelle (control.h)

[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 IMediaPosition-Schnittstelle enthält Methoden zum Suchen nach einer Position in einem Stream.

Hinweis Anwendungen sollten IMediaSeeking anstelle von IMediaPosition verwenden.
 

Diese Schnittstelle wird sowohl vom Filter Graph Manager als auch von einzelnen Filtern verfügbar gemacht. Anwendungen sollten einen IMediaPosition-Schnittstellenzeiger aus dem Filtergraph-Manager und nicht aus einem Filter abrufen. Der Filter Graph Manager verteilt Methodenaufrufe an alle Rendererfilter. Die Rendererfilter verteilen die Aufrufe Upstream an die Quellfilter. Diese Ereignissequenz stellt sicher, dass alle Datenströme synchronisiert bleiben.

Wenn einer der verteilten Aufrufe einen Fehler zurückgibt, gibt der Filter Graph-Manager den ersten empfangenen Fehlerwert zurück. Einige der verteilten Aufrufe sind in diesem Fall möglicherweise erfolgreich. Das Filterdiagramm gibt jedoch nicht E_NOTIMPL zurück, es sei denn, alle verteilten Aufrufe geben E_NOTIMPL zurück. Wenn mindestens ein Filter im Diagramm die -Methode implementiert, gibt der Filter Graph-Manager keine E_NOTIMPL zurück.

Vererbung

Die IMediaPosition-Schnittstelle erbt von der IDispatch-Schnittstelle . IMediaPosition verfügt auch über folgende Arten von Membern:

Methoden

Die IMediaPosition-Schnittstelle verfügt über diese Methoden.

 
IMediaPosition::CanSeekBackward

Die CanSeekBackward-Methode bestimmt, ob das Filterdiagramm rückwärts im Stream suchen kann.
IMediaPosition::CanSeekForward

Die CanSeekForward-Methode bestimmt, ob das Filterdiagramm im Stream nach vorne suchen kann.
IMediaPosition::get_CurrentPosition

Die get_CurrentPosition-Methode ruft die aktuelle Position relativ zur Gesamtdauer des Datenstroms ab.
IMediaPosition::get_Duration

Die get_Duration-Methode ruft die Dauer des Datenstroms ab.
IMediaPosition::get_PrerollTime

Die get_PrerollTime-Methode ruft die Datenmenge ab, die vor der Startposition in die Warteschlange gestellt wird.
IMediaPosition::get_Rate

Die get_Rate-Methode ruft die Wiedergaberate ab.
IMediaPosition::get_StopTime

Die get_StopTime-Methode ruft den Zeitpunkt ab, zu dem die Wiedergabe beendet wird, relativ zur Dauer des Datenstroms.
IMediaPosition::p ut_CurrentPosition

Die put_CurrentPosition-Methode legt die aktuelle Position relativ zur Gesamtdauer des Datenstroms fest.
IMediaPosition::p ut_PrerollTime

Die put_PrerollTime-Methode legt die Datenmenge fest, die vor der Startposition in die Warteschlange gestellt wird.
IMediaPosition::p ut_Rate

Die put_Rate-Methode legt die Wiedergaberate fest.
IMediaPosition::p ut_StopTime

Die put_StopTime-Methode legt den Zeitpunkt fest, zu dem die Wiedergabe beendet wird, relativ zur Dauer des Datenstroms.

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)

Weitere Informationen

IDispatch