IAMTimecodeReader：：GetTimecode 方法 (strmif.h)

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

方法 GetTimecode 會擷取數據流中可用的最近時間代碼、使用者位和旗標值。

語法

HRESULT GetTimecode(
  [out] PTIMECODE_SAMPLE pTimecodeSample
);

參數

[out] pTimecodeSample

TIMECODE_SAMPLE 結構的指標。

傳回值

傳回取決於介面實作的 HRESULT 值。

備註

使用這個方法來監視 timecode，以及剖析重複專案和不連續。

timecode 包含未定義的位，稱為 userbits。 應用程式可以使用這些位來儲存同步處理資訊或其他自訂資訊。

DV 和 MPEG Camcorder 實作

MSDV 驅動程式支援讀取 SMPTE timecode 或絕對追蹤編號， (ATN) 。 MSTape 驅動程式支援讀取 RTC) (相對時間計數器。 若要讀取這些裝置上的時間資訊，請執行下列動作：

將 TIMECODE_SAMPLE 結構的 dwFlags 成員設定為下列其中一個值。

常數	描述
ED_DEVCAP_TIMECODE_READ	Timecode (DV)
ED_DEVCAP_ATN_READ	DV) (絕對曲目編號
ED_DEVCAP_RTC_READ	相對時間計數器 (MPEG 磁帶)

 

TIMECODE_SAMPLE 結構的 timecode 成員是 TIMECODE 結構。 將結構的 dwFrames 成員初始化為零。

所有其他結構成員都會被忽略。

當方法傳回時， dwFrames 成員會以下列格式包含時間資訊。

時間資訊	格式
Timecode	小時、分鐘、秒和框架，以二進位編碼十進位 (BCD) 值： 0xhhmmssff。
Atn	追蹤編號。
RTC	小時、分鐘、秒和框架，以 BCD 值表示： 0xhhmmssff。 框架位元組的最顯著位是符號位。 如果畫面計數無法使用，剩餘的畫面位會設定為 0x7F。

 

此外， dwUser 成員會從裝置接收 空白旗標 位，其中包含下列其中一個值。

值	Description
0x00	不是不連續的。
0x01	間斷。

規格需求

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

另請參閱

錯誤和成功碼

從裝置取得 Timecode

IAMTimecodeReader 介面