iMediaFilter：：SetSyncSource 方法 (strmif.h)

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

方法會 SetSyncSource 設定參考時鐘。

語法

HRESULT SetSyncSource(
  [in] IReferenceClock *pClock
);

參數

[in] pClock

時鐘 IReferenceClock 介面的指標，或 Null。 如果此參數為 Null，篩選圖表不會使用參考時鐘，而且所有篩選準則都會儘快執行。

傳回值

如果成功，則傳回S_OK，或指出錯誤原因的 HRESULT 值。

備註

篩選圖形中的所有篩選都會共用相同的參考時鐘，以便保持同步。 資料流程時間是從參考時鐘計算而來。 轉譯器篩選會使用參考時鐘來排程轉譯樣本的時間。 如果沒有參考時鐘，轉譯器篩選會在到達時立即轉譯每個樣本。

這個方法是由所有 DirectShow 篩選實作，也是由 Filter Graph 管理員實作。

篩選實作

當圖表執行時，Filter Graph 管理員會在圖形中的每個篩選上呼叫這個方法，以通知它們圖形參考時鐘。 使用這個方法來儲存 IReferenceClock 指標。 遞增預存指標上的參考計數。 在從圖形中移除篩選之前，Filter Graph Manager 會再次以Null值呼叫SetSyncSource。 釋放儲存的指標，並將其設定為 Null。

CBaseFilter類別會實作這個方法;請參閱CBaseFilter：：SetSyncSource。

請注意，篩選準則無法使用這個方法來選取圖形時鐘。 在篩選中，這個方法的唯一函式是通知時鐘的篩選正在使用圖形。 篩選準則可以藉由公開 IReferenceClock 介面來提供參考時鐘。 如需詳細資訊，請參閱 DirectShow 中的時間和時鐘。

應用程式使用

應用程式可以在 Filter Graph 管理員上呼叫 SetSyncSource 來覆寫預設時鐘。 除非您有偏好另一個時鐘的特定原因，否則請勿這麼做。 您也可以使用Null值呼叫SetSyncSource，以設定圖形不要使用任何參考時鐘。 您可以執行此動作，儘快處理範例。 如需詳細資訊，請參閱 設定 Graph 時鐘。

應用程式不應該在篩選上呼叫這個方法。

規格需求

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

另請參閱

錯誤和成功碼

IFilterGraph：：SetDefaultSyncSource

IMediaFilter 介面