IMediaPosition：:p ut_CurrentPosition 方法 (control.h)

  • 發行項

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式碼，以使用新的 API。]

方法會 put_CurrentPosition 設定相對於資料流程總持續時間的目前位置。

語法

HRESULT put_CurrentPosition(
  [in] REFTIME llTime
);

參數

[in] llTime

新位置，以秒為單位。

傳回值

傳回 HRESULT 值。 可能的值如下：

傳回碼 Description
S_FALSE
 圖形已暫停，且正在轉換回執行中狀態。
S_OK
 成功。
E_INVALIDARG
 無效引數。
E_NOTIMPL
 未實作。

備註

llTime參數所指定的位置相對於總持續時間，忽略播放速率。 例如，如果來源檔案的長度為 10 秒，則不論播放速率為何，將位置設定為 5.0 會導致圖形在檔案中間搜尋。

如果篩選圖表正在執行，篩選圖形管理員會暫停圖形、發出 seek 命令，然後再次執行圖形。 如果方法在圖形仍在轉換為執行中狀態時傳回，則會S_FALSE傳回值。

如果篩選在收到搜尋命令時暫停，它必須先排清現有的資料，才能從新位置導入資料。 請參閱 IPin：：BeginFlush 和 IPin：：EndFlush。

規格需求

   
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 control.h (包含 Dshow.h)
程式庫 Strmiids.lib

另請參閱

錯誤和成功碼

IMediaPosition 介面