IMFPresentationClock::Start 方法 (mfidl.h)
啟動簡報時鐘。
語法
HRESULT Start(
[in] LONGLONG llClockStartOffset
);
參數
[in] llClockStartOffset
初始開始時間,以 100 奈秒為單位。 呼叫 Start 方法時,時鐘的 IMFPresentationClock::GetTime 方法會傳回此值,而時鐘時間會從該處遞增。 如果值PRESENTATION_CURRENT_POSITION,時鐘會從其目前的位置開始。 如果時鐘已暫停,而且您想要從相同位置重新啟動,請使用此值。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
|
沒有在此時鐘上設定時間來源。 |
備註
此方法在所有狀態都有效, (已停止、暫停或執行) 。
如果時鐘已暫停並從相同位置重新啟動, (llClockStartOffset PRESENTATION_CURRENT_POSITION) ,簡報時鐘會傳送 IMFClockStateSink::OnClockRestart 通知。 否則,時鐘會傳送 IMFClockStateSink::OnClockStart 通知。
簡報時鐘會在時鐘的時間來源上呼叫 OnClockStart 或 OnClockRestart 來起始狀態變更。 此呼叫會同步進行。 如果失敗,則不會發生狀態變更。 如果呼叫成功,狀態會變更,而時鐘會藉由呼叫其 OnClockStart 或 OnClockRestart 方法來通知其他狀態變更訂閱者。 這些呼叫會以異步方式進行。
如果時鐘已在執行中,再次呼叫 Start 會影響搜尋時鐘到新的 StartOffset 位置。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | mfidl.h |
程式庫 | Mfuuid.lib |