IMFByteStream::SetCurrentPosition-Methode (mfobjects.h)

  • Artikel

Legt die aktuelle Lese- oder Schreibposition fest.

Syntax

HRESULT SetCurrentPosition(
  [in] QWORD qwPosition
);

Parameter

[in] qwPosition

Neue Position im Stream als Byteoffset vom Anfang des Datenstroms.

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.
E_INVALIDARG
 Ungültiges Argument.

Hinweise

Wenn die neue Position größer als die Länge des Datenstroms ist, gibt die Methode E_INVALIDARG zurück.

Implementierungshinweise:Diese Methode sollte die aktuelle Position im Stream aktualisieren, indem die aktuelle Position auf den Wert festgelegt wird, der an den qwPosition-Parameter übergeben wird. Weitere Methoden, die die aktuelle Position aktualisieren können, sind Read, BeginRead, Write, BeginWrite und Seek.

Diese Schnittstelle ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Windows Media Format 11 SDK-Komponenten installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfobjects.h (include Mfidl.h)
Bibliothek Mfuuid.lib

Weitere Informationen

IMFByteStream