IMFPresentationClock：：Start 方法 (mfidl.h)

  • 發行項

啟動簡報時鐘。

語法

HRESULT Start(
  [in] LONGLONG llClockStartOffset
);

參數

[in] llClockStartOffset

初始開始時間，以 100 奈秒為單位。 呼叫 Start 方法時，時鐘的 IMFPresentationClock：：GetTime 方法會傳回此值，而時鐘時間會從該處遞增。 如果值PRESENTATION_CURRENT_POSITION，時鐘會從其目前的位置開始。 如果時鐘已暫停，而且您想要從相同位置重新啟動，請使用此值。

傳回值

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

傳回碼 描述
S_OK
 此方法已成功。
MF_E_CLOCK_NO_TIME_SOURCE
 沒有在此時鐘上設定時間來源。

備註

此方法在所有狀態都有效， (已停止、暫停或執行) 。

如果時鐘已暫停並從相同位置重新啟動， (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

另請參閱

IMFPresentationClock

簡報時鐘