IDCompositionAnimation::End 方法 (dcompanimation.h)

加入結束區段,以標記動畫函式的結尾。

語法

HRESULT End(
  [in] double endOffset,
  [in] float  endValue
);

參數

[in] endOffset

類型: double

從動畫函式的開頭到函式結束時的點,以秒為單位的位移。

[in] endValue

類型: float

動畫的最終值。

傳回值

類型: HRESULT

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

備註

達到指定的位移時,此動畫所影響的屬性或屬性會設定為指定的最終值,然後動畫停止。 如果未新增結束區段,動畫函式的最後一個區段會無限期執行。 呼叫這個方法的語意與讓動畫函式的最後一個區段成為三次方多項式,其中立方體、二次方和線性係數全都是零,而常數係數是所需的最終值。

因為動畫區段必須依遞增順序新增,所以如果 endOffset 參數小於或等於上一個區段的 beginOffset 參數,這個方法就會失敗。 如果這是要新增至動畫函式的第一個區段,這個方法也會失敗。

呼叫這個方法之後,此動畫物件上的所有方法都會失敗,但 IDCompositionAnimation::Reset 方法除外。

需求

   
最低支援的用戶端 Windows 8 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
目標平台 Windows
標頭 dcompanimation.h
程式庫 Dcomp.lib
Dll Dcomp.dll

另請參閱

IDCompositionAnimation