IMFClockStateSink::OnClockStop 方法 (mfidl.h)

當簡報時鐘停止時呼叫。

語法

HRESULT OnClockStop(
  [in] MFTIME hnsSystemTime
);

參數

[in] hnsSystemTime

時鐘停止的系統時間,以 100 奈秒為單位。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
此方法已成功。
MF_E_SINK_ALREADYSTOPPED
已取代。 請勿使用此錯誤碼。

備註

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

對於不是簡報時間來源的任何物件,在狀態變更完成後,會以非同步方式呼叫 OnClockStop 方法。

如果物件已經停止,它應該會從OnClockStop傳回S_OK。 它不應該傳回錯誤碼。

注意 雖然標頭檔 mferror.h 定義名為 MF_E_SINK_ALREADYSTOPPED的錯誤碼,但在此情況下不應該傳回。
 

需求

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

另請參閱

IMFClockStateSink

MFTIME

簡報時鐘