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

簡報時鐘