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