共用方式為

IAMStreamControl：：StartAt 方法 (strmif.h)

  • 發行項

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

方法 StartAt 會通知釘選何時開始傳遞數據。

語法

HRESULT StartAt(
  [in] const REFERENCE_TIME *ptStart,
  [in] DWORD                dwCookie
);

參數

[in] ptStart

REFERENCE_TIME 值的指標 ，指定釘選何時應該開始傳遞數據。 如果值為 MAXLONGLONG (0x7FFFFFFFFFFFFFFF) ，此方法會取消先前的開始要求。 如果 psStart 為 NULL，則針腳會在圖形執行時立即啟動。

對於預覽針腳，只有 NULL 和 MAXLONGLONG 值有效，因為預覽針腳不會時間戳它們所提供的範例。

[in] dwCookie

指定要連同開始通知一起傳送的值。 請參閱＜備註＞。

傳回值

如果方法成功，傳回值會S_OK。 否則，傳回 HRESULT 值，指出失敗的原因。

備註

根據預設，針腳會在篩選圖形執行時提供數據。 方法 StartAt 會導致釘選在圖形執行之後的指定時間等候，再開始傳遞數據。

如果 dwCookie 參數不是零，則針腳會在開始傳遞數據時傳送 EC_STREAM_CONTROL_STARTED 事件。 第一個事件參數是針腳的 IPin 介面指標，第二個是 dwCookie 的值。

此方法會實作下列特殊案例：

  • 如果 ptStart 為 NULL，則圖執行時會立即啟動針腳。 不會傳送事件，而且 會忽略 dwCookie 的值。
  • 如果 ptStart 包含 MAXLONGLONG 值，而且有擱置的停止要求，則圖執行時會啟動針腳。 如果沒有擱置的停止要求，釘選會保持停止狀態。 在這兩種情況下，不會傳送任何啟動事件，而且 會忽略 dwCookie 的值。
此方法也會處理下列界限條件：
  • 如果開始時間落在樣本的開始和停止時間之間，則針腳會傳遞該樣本。
  • 如果開始時間等於停止時間，則針腳會傳遞一個範例。
MAXLONGLONG 是最大可能 REFERENCE_TIME 值。 在基類庫中，它也會定義為常 數MAX_TIME。

規格需求

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

另請參閱

錯誤和成功碼

IAMStreamControl 介面