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 通知。

演示时钟通过在时钟的时间源上调用 OnClockStartOnClockRestart 来启动状态更改。 此调用是同步进行的。 如果失败,则不会发生状态更改。 如果调用成功,状态将更改,时钟将通过调用其他状态更改订阅者 OnClockStartOnClockRestart 方法通知这些订阅者。 这些调用是异步进行的。

如果时钟已在运行,则再次调用 Start 的效果是将时钟查找到新的 StartOffset 位置。

要求

要求
最低受支持的客户端 Windows Vista [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2008 [桌面应用 | UWP 应用]
目标平台 Windows
标头 mfidl.h
Library Mfuuid.lib

另请参阅

IMFPresentationClock

演示文稿时钟