IDCompositionAnimation：：SetAbsoluteBeginTime 方法 (dcompanimation.h)

設定動畫函式開始的絕對時間。

語法

HRESULT SetAbsoluteBeginTime(
  [in] LARGE_INTEGER beginTime
);

[in] beginTime

類型： LARGE_INTEGER

此動畫的開始時間。

類型： HRESULT

如果函式成功，它會傳回S_OK。否則，它會傳回 HRESULT 錯誤碼。如需錯誤碼的清單，請參閱 DirectComposition 錯誤碼。

根據預設，動畫函式會在動畫的第一個畫面格生效時啟動。例如，如果應用程式在位移零建立具有單一基本型別的簡單動畫函式，請將動畫與某些屬性產生關聯，然後呼叫 IDCompositionDevice：：Commit 方法，第一個框架，其中包含第一個基本類型位移零處的動畫認可樣本。

這表示所有動畫的實際預設開始時間會根據應用程式建立動畫和呼叫 Commit的時間而有所不同，取決於組合引擎挑選已認可的變更所需的時間。應用程式可以使用 SetAbsoluteBeginTime 方法，更精細地控制動畫的開始時間。

這個方法不會控制動畫何時生效;它只會影響動畫在開始之後取樣的方式。如果應用程式將下一個畫面的確切時間指定為絕對開始時間，則結果與完全不呼叫此方法相同。如果指定的開始時間與下一個畫面格的時間不同，結果為下列其中一項：