control.h (MediaPosition 介面)

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

另請參閱

IDispatch