共用方式為


IMFClockStateSink::OnClockStart 方法 (mfidl.h)

當簡報時鐘啟動時呼叫。

語法

HRESULT OnClockStart(
  [in] MFTIME   hnsSystemTime,
  [in] LONGLONG llClockStartOffset
);

參數

[in] hnsSystemTime

時鐘啟動時的系統時間,以 100 奈秒為單位。

[in] llClockStartOffset

時鐘的新開始時間,以 100 奈秒為單位。 此參數也可以等於 PRESENTATION_CURRENT_POSITION,表示時鐘已從目前位置啟動或重新開機。

傳回值

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

備註

呼叫簡報時鐘的 IMFPresentationClock::Start 方法時,會呼叫這個方法,但有下列例外狀況:如果暫停時鐘且使用值呼叫 StartPRESENTATION_CURRENT_POSITION則會呼叫 IMFClockStateSink::OnClockRestart ,而不是 OnClockStart

時鐘會呼叫時間來源的 OnClockStart 方法,以通知簡報時間來源。 這個呼叫會在 Start 方法內同步發生。 如果時間來源從 OnClockStart傳回錯誤,簡報時鐘的 Start 方法會傳回錯誤,而且不會發生狀態變更。

對於不是呈現時間來源的任何物件,在狀態變更完成後,會以非同步方式呼叫 OnClockStart 方法。 在此情況下,會忽略這個方法的傳回值。

llClockStartOffset中指定的值是時鐘啟動時的簡報時間,因此相對於簡報的開頭。 媒體接收不應該轉譯簡報時間早于 llClockStartOffSet的任何資料。 如果樣本跨越位移,亦即,如果位移落在樣本的開始和停止時間之間,接收應該修剪樣本,如此才會轉譯 llClockStartOffset 之後的資料,或者只卸載樣本。

需求

   
最低支援的用戶端 Windows Vista [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 mfidl.h
程式庫 Mfuuid.lib

另請參閱

IMFClockStateSink

MFTIME

簡報時鐘