IDCompositionVisual3：：SetTransform (constD2D_MATRIX_4X4_F&) 方法 (dcomp.h)

將這個視覺效果的 Transform 屬性設定為指定的 4 by-4 轉換矩陣。

語法

HRESULT SetTransform(
  [in, ref] const D2D_MATRIX_4X4_F & matrix
);

[in, ref] matrix

類型： const D2D_MATRIX_4X4_F

用來修改此視覺效果座標系統的 4 by-4 轉換矩陣。

類型： HRESULT

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

設定 Transform 屬性會轉換此視覺效果根目錄之整個視覺子樹的座標系統。如果指定這個視覺效果的 Clip 屬性，也會轉換裁剪矩形。

如果轉換屬性先前指定了轉換物件，則新指定的轉換矩陣會取代轉換物件。