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 |