IDCompositionAnimation：：AddSinusoidal 方法 (dcompanimation.h)

將正弦線段新增至動畫函式。

語法

HRESULT AddSinusoidal(
  double beginOffset,
  float  bias,
  float  amplitude,
  float  frequency,
  float  phase
);

beginOffset

類型： double

從動畫函式的開頭到此區段應該生效的點的位移，以秒為單位。

bias

類型： float

加入至正弦數的常數。

amplitude

類型： float

套用至正弦數的縮放比例。

frequency

類型： float

在 Hertz 中套用至時間位移的縮放比例。

phase

類型： float

加入時間位移的常數，以度為單位。

類型： HRESULT

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

如果任一參數為 NaN、正無限大或負無限大，或 beginOffset 參數為負數，這個方法就會失敗。

由於動畫區段必須以遞增順序新增，因此如果 beginOffset 參數小於或等於前一個區段的 beginOffset 參數，則此方法會失敗。如果有的話。

此動畫區段會持續生效，直到動畫函式中下一個線段的開始時間為止。如果動畫函式不包含更多區段，此區段會無限期維持作用。