IDCompositionTarget：：SetRoot 方法 (dcomp.h)

将可视对象设置为可视化树的新根对象。

语法

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

[in, optional] visual

此可视化树的新根的视觉对象。此参数可以为 NULL。

类型： HRESULT

如果函数成功，则返回S_OK。否则，将返回 HRESULT 错误代码。有关错误代码列表，请参阅 DirectComposition 错误代码。

视觉对象可以是单个视觉树的根目录，也可以是另一个视觉对象的子级，但它不能同时是两者。如果 视觉对象 参数已是另一个视觉树的根，或者是另一个视觉对象的子级，则此方法将失败。

如果 视觉对象 为 NULL，则可视化树为空。如果存在以前的非 NULL 根视觉对象，则该视觉对象将可用作另一个视觉树的根目录或另一个视觉对象的子视觉对象。