IMFSourceReader::SetCurrentPosition-Methode (mfreadwrite.h)

Sucht nach einer neuen Position in der Medienquelle.

Syntax

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

Die 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:

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

[in] varPosition

Die Position, an der die Wiedergabe gestartet wird. Die Einheiten werden durch den parameter guidTimeFormat angegeben. Wenn der parameter guidTimeFormatGUID_NULL ist, legen Sie den Variant-Typ auf VT_I8 fest.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt.

Bemerkungen

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

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 Plattformupdate-Ergänzung für Windows Vista installiert ist.

Anforderungen

Siehe auch

IMFSourceReader-

Quellleser