IDCompositionTarget：：SetRoot 方法 (dcomp.h)

將可視化物件設定為可視化樹狀結構的新根物件。

語法

HRESULT SetRoot(
  [in, optional] IDCompositionVisual *visual
);

[in, optional] visual

這個可視化樹狀結構的新根目錄的視覺物件。此參數可以是 NULL。

類型： HRESULT

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

視覺效果可以是單一可視化樹狀結構的根目錄，或是另一個視覺效果的子系，但不能同時是兩者。如果視覺參數已經是另一個可視化樹狀結構的根目錄，或是另一個視覺效果的子系，這個方法就會失敗。

如果 視覺效果 為 NULL，則可視化樹狀結構是空的。如果有先前的非 NULL 根視覺效果，該視覺效果會變成可用做為另一個可視化樹狀結構的根目錄，或是另一個視覺效果的子系。