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.
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) |