共用方式為

IMFByteStream：：Seek 方法 (mfobjects.h)

  • 發行項

依指定的位移移動數據流中的目前位置。

語法

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

參數

[in] SeekOrigin

指定搜尋的來源做為 MFBYTESTREAM_SEEK_ORIGIN 列舉的成員。 位移會相對於這個位置計算。

[in] llSeekOffset

指定新位置，做為搜尋原點的位元組位移。

[in] dwSeekFlags

指定零個或多個旗標。 定義下列旗標。

值 意義
MFBYTESTREAM_SEEK_FLAG_CANCEL_PENDING_IO
 搜尋要求成功完成之後，所有擱置的 I/O 要求都會取消。

[out] pqwCurrentPosition

在搜尋之後收到新位置。

傳回值

如果此方法成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

如果已安裝 Windows Media Format 11 SDK 可轉散發元件，此介面可在下列平臺上使用：

  • Windows XP with Service Pack 2 (SP2) 和更新版本。
  • 已安裝 Windows XP Media Center Edition 2005 KB900325 (Windows XP Media Center 版本 2005) 和 KB925766 (2006 年 10 月更新匯總) 。
實作注意事項： 此方法應該藉由將 qwSeekOffset 新增至 seekOrigin 位置，以更新數據流中的目前位置。 這應該是 pqwCurrentPosition 參數中傳回的相同值。 其他可更新目前位置的方法包括 Read、 BeginRead、 Write、 BeginWrite 和 SetCurrentPosition。

規格需求

需求 值
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfobjects.h (include Mfidl.h)
程式庫 Mfuuid.lib

另請參閱

IMFByteStream