CPullPin.Seek 方法

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

方法 Seek 會設定資料流程的開始和停止位置。

語法

HRESULT Seek(
   REFERENCE_TIME tStart,
   REFERENCE_TIME tStop
);

參數

tStart

指定開始位置,以位元組為單位乘以 10,000,000。

tStop

指定停止位置,以位元組為單位乘以 10,000,000。

傳回值

如果方法成功,則傳回S_OK,否則傳回錯誤碼。

備註

如果背景工作執行緒正在執行,此方法會暫停執行緒、排清篩選圖形,然後繼續執行緒。 執行緒會開始從新的開始位置提取資料。 否則,每當執行緒啟動時,新的位置值就會生效。

位置相對於原始來源的開頭。 將所需的位元組位移乘以常數 UNITS,其定義在基類程式庫中定義為 10,000,000。

第一次連接針腳時,停止和開始位置預設為數據流的開頭和結尾。

規格需求

需求
標頭
Pullpin.h
程式庫
Strmbase.lib (零售組建) ;
Strmbasd.lib (偵錯組建)

另請參閱

CPullPin 類別