Share via

IMFSourceReader::SetCurrentPosition-Methode (mfreadwrite.h)

  • Artikel

Sucht eine neue Position in der Medienquelle.

Syntax

HRESULT SetCurrentPosition(
  [in] REFGUID        guidTimeFormat,
  [in] REFPROPVARIANT varPosition
);

Parameter

[in] guidTimeFormat

Eine GUID, die das Zeitformat angibt. Das Zeitformat definiert die Einheiten für den varPosition-Parameter . Der folgende Wert ist für alle Medienquellen definiert:

Wert Bedeutung
GUID_NULL
 Einheiten von 100 Nanosekunden.
 

Einige Medienquellen unterstützen möglicherweise zusätzliche Werte.

[in] varPosition

Die Position, von der aus die Wiedergabe gestartet wird. Die Einheiten werden durch den guidTimeFormat-Parameter angegeben. Wenn der guidTimeFormat-ParameterGUID_NULL ist, legen Sie den Variant-Typ auf VT_I8 fest.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode Beschreibung
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_INVALIDREQUEST
 Mindestens eine Beispielanforderung steht noch aus.

Hinweise

Die SetCurrentPosition-Methode garantiert keine genaue Suche. Die Genauigkeit der Suche hängt von den Medieninhalten ab. Wenn der Medieninhalt einen Videostream enthält, sucht die SetCurrentPosition-Methode in der Regel nach dem nächstgelegenen Keyframe vor der gewünschten Position. Der Abstand zwischen Keyframes hängt von mehreren Faktoren ab, einschließlich der Encoderimplementierung, dem Videoinhalt und den speziellen Codierungseinstellungen, die zum Codieren des Inhalts verwendet werden. Der Abstand zwischen keyframes kann innerhalb einer einzelnen Videodatei variieren (z. B. abhängig von der Komplexität der Szene).

Nach der Suche sollte die Anwendung IMFSourceReader::ReadSample aufrufen und zur gewünschten Position wechseln.

Diese Schnittstelle ist unter Windows Vista verfügbar, wenn die Plattformupdateergänzung für Windows Vista installiert ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7, Windows Vista und Plattform-Update-Ergänzung für Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfreadwrite.h

Weitere Informationen

IMFSourceReader

Quellleser