IMFByteStream::Seek-Methode (mfobjects.h)

Artikel
03/01/2024

Verschiebt die aktuelle Position im Stream um einen angegebenen Offset.

Syntax

HRESULT Seek(
  [in]  MFBYTESTREAM_SEEK_ORIGIN SeekOrigin,
  [in]  LONGLONG                 llSeekOffset,
  [in]  DWORD                    dwSeekFlags,
  [out] QWORD                    *pqwCurrentPosition
);

Parameter

[in] SeekOrigin

Gibt den Ursprung der Suche als Member der MFBYTESTREAM_SEEK_ORIGIN-Enumeration an. Der Offset wird relativ zu dieser Position berechnet.

[in] llSeekOffset

Gibt die neue Position als Byteoffset vom Suchursprung an.

[in] dwSeekFlags

Gibt null oder mehr Flags an. Die folgenden Flags werden definiert.

Wert	Bedeutung
MFBYTESTREAM_SEEK_FLAG_CANCEL_PENDING_IO	Alle ausstehenden E/A-Anforderungen werden abgebrochen, nachdem die Suchanforderung erfolgreich abgeschlossen wurde.

[out] pqwCurrentPosition

Empfängt die neue Position nach der Suche.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

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.

Implementierungshinweise: Diese Methode sollte die aktuelle Position im Stream aktualisieren, indem sie der SeekOrigin-PositionqwSeekOffset hinzufügt. Dies sollte der gleiche Wert sein, der im pqwCurrentPosition-Parameter zurückgegeben wird. Weitere Methoden, die die aktuelle Position aktualisieren können, sind Read, BeginRead, Write, BeginWrite und SetCurrentPosition.

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

Freigeben über