control.h (MediaPosition 介面)
[與此頁面 相關的功能 DirectShow 是舊版功能。 它已被 MediaPlayer、 IMFMediaEngine 和 Media Foundation 中的音訊/視訊擷取取代。 這些功能已針對 Windows 10 和 Windows 11 進行優化。 Microsoft 強烈建議新程式代碼盡可能使用 MediaPlayer、 IMFMediaEngine 和 音訊/視訊擷取 ，而不是 DirectShow。 Microsoft 建議盡可能重寫使用舊版 API 的現有程式代碼，以使用新的 API。]
IMediaPosition 介面包含搜尋數據流內某個位置的方法。
注意 應用程式應該使用 IMediaSeeking 而不是 IMediaPosition。
此介面是由篩選圖形管理員和個別篩選公開。 應用程式應該會從篩選圖形管理員取得 IMediaPosition 介面指標，而不是從篩選條件取得。 Filter Graph 管理員會將方法呼叫散發到所有轉譯器篩選。 轉譯器篩選會將呼叫上游傳播至來源篩選條件。 此事件序列可確保所有資料流保持同步。
如果其中一個分散式呼叫傳回錯誤，Filter Graph Manager 會傳回它收到的第一個錯誤值。 在此情況下，某些分散式呼叫可能會成功。 不過，除非所有分散式呼叫都會傳回 E_NOTIMPL ，否則篩選圖表不會傳回 E_NOTIMPL。 如果圖形中至少有一個篩選實作 方法，則 Filter Graph 管理員不會傳回 E_NOTIMPL。
繼承
IMediaPosition 介面繼承自 IDispatch 介面。 IMediaPosition 也有下列類型的成員：
方法
IMediaPosition 介面具有這些方法。
| IMediaPosition：：CanSeekBackward CanSeekBackward 方法會判斷篩選圖形是否可以在數據流中向後搜尋。 |
| IMediaPosition：：CanSeekForward CanSeekForward 方法會判斷篩選圖形是否可以在數據流中向前搜尋。 |
| IMediaPosition：：get_CurrentPosition get_CurrentPosition 方法會擷取相對於數據流總持續時間的目前位置。 |
| IMediaPosition：：get_Duration get_Duration 方法會擷取數據流的持續時間。 |
| IMediaPosition：：get_PrerollTime get_PrerollTime 方法會擷取將在開始位置之前排入佇列的數據量。 |
| IMediaPosition：：get_Rate get_Rate 方法會擷取播放速率。 |
| IMediaPosition：：get_StopTime get_StopTime 方法會擷取播放相對於數據流持續時間停止的時間。 |
| IMediaPosition：:p ut_CurrentPosition put_CurrentPosition方法會設定相對於數據流總持續時間的目前位置。 |
| IMediaPosition：:p ut_PrerollTime put_PrerollTime 方法會設定在開始位置之前排入佇列的數據量。 |
| IMediaPosition：:p ut_Rate put_Rate方法會設定播放速率。 |
| IMediaPosition：:p ut_StopTime put_StopTime 方法會設定播放相對於數據流持續時間停止的時間。 |
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | control.h (包含 Dshow.h) |