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
Library Mfuuid.lib

另请参阅

IMFPresentationClock

演示文稿时钟