共用方式為


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

[與此頁面 相關的功能 DirectShow是舊版功能。 它已被 MediaPlayerIMFMediaEngineMedia Foundation 中的音訊/視訊擷取取代。 這些功能已針對Windows 10和Windows 11進行優化。 Microsoft 強烈建議新程式碼盡可能使用 MediaPlayerIMFMediaEngine音訊/視訊擷取 ,而不是 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::BeginFlushIPin::EndFlush

規格需求

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

另請參閱

錯誤和成功碼

IMediaPosition 介面