IDCompositionRotateTransform3D：：SetAxisZ (IDCompositionAnimation*) 方法 (dcomp.h)

以動畫顯示 3D 旋轉轉換的 AxisZ 屬性值。 AxisZ 屬性會指定旋轉軸向量的 z 座標。預設值為 1.0。

語法

HRESULT SetAxisZ(
  [in] IDCompositionAnimation *animation
);

[in] animation

動畫物件，決定 AxisZ 屬性的值如何隨著時間變更。此參數不得為 NULL。

類型： HRESULT

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

將座標軸設定為非預設值時，您應該一律在 AxisX、AxisY 和 AxisZ) (三個座標軸屬性。

這個方法會建立指定動畫的複本。如果在呼叫此方法之後，動畫參數所參考的對象已變更，除非再次呼叫此方法，否則變更不會影響AxisZ 屬性。如果 AxisZ 屬性先前是動畫，則呼叫這個方法會將先前的動畫取代為新的動畫。

如果動畫是無效的指標，或不是由與受影響 3D 轉換相同的 IDCompositionDevice 介面所建立，這個方法就會失敗。介面不能是自定義實作;只有由 Microsoft DirectComposition 建立的介面可以搭配這個方法使用。

預設值為 0。