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 |
---|---|
|
圖形已暫停,且正在轉換回執行中狀態。 |
|
成功。 |
|
無效引數。 |
|
未實作。 |
備註
llTime參數所指定的位置相對於總持續時間,忽略播放速率。 例如,如果來源檔案的長度為 10 秒,則不論播放速率為何,將位置設定為 5.0 會導致圖形在檔案中間搜尋。
如果篩選圖表正在執行,篩選圖形管理員會暫停圖形、發出 seek 命令,然後再次執行圖形。 如果方法在圖形仍在轉換為執行中狀態時傳回,則會S_FALSE傳回值。
如果篩選在收到搜尋命令時暫停,它必須先排清現有的資料,才能從新位置導入資料。 請參閱 IPin::BeginFlush 和 IPin::EndFlush。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | control.h (包含 Dshow.h) |
程式庫 | Strmiids.lib |