IDCompositionAnimation：：SetAbsoluteBeginTime 方法 (dcompanimation.h)

设置动画函数开始的绝对时间。

语法

HRESULT SetAbsoluteBeginTime(
  [in] LARGE_INTEGER beginTime
);

[in] beginTime

类型： LARGE_INTEGER

此动画的开始时间。

类型： HRESULT

如果函数成功，则返回S_OK。否则，将返回 HRESULT 错误代码。有关错误代码列表，请参阅 DirectComposition 错误代码。

默认情况下，动画函数在动画的第一帧生效时启动。例如，如果应用程序创建一个位于偏移零的单个基元的简单动画函数，则将动画与某个属性相关联，然后调用 IDCompositionDevice：：Commit 方法，则包含提交的第一个帧对第一个基元的偏移零处的动画采样。

这意味着，所有动画的实际默认开始时间因应用程序创建动画并调用 Commit 到合成引擎选取已提交更改所花费的时间而异。应用程序可以使用 SetAbsoluteBeginTime 方法对动画的开始时间进行精细控制。

此方法不控制动画何时生效;它仅影响动画在启动后如何采样。如果应用程序将下一帧的确切时间指定为绝对开始时间，则结果与根本不调用此方法相同。如果指定的开始时间与下一帧的时间不同，则结果如下：