IDirectManipulationCompositor2：：AddContentWithCrossProcessChaining 方法 (directmanipulation.h)

项目
03/05/2024

将组件主机) 拥有的内容 (与合成器相关联，为内容分配合成设备，并指定内容在组合树中相对于其他合成视觉对象的位置。表示一个合成器对象，该对象将操作的内容与跨多个进程绘制图面相关联。

语法

HRESULT AddContentWithCrossProcessChaining(
  [in] IDirectManipulationPrimaryContent *content,
  [in] IUnknown                          *device,
  [in] IUnknown                          *parentVisual,
  [in] IUnknown                          *childVisual
);

参数

[in] content

要添加到合成树的内容。

内容放置在合成树中的 parentVisual 和 childVisual 之间。

只有与视区同时创建的主要内容有效。

[in] device

用于撰写内容的设备。

请注意，设备 由应用程序创建。

[in] parentVisual

要添加的内容的组合树中的父视觉对象。

parentVisual 还必须是合成树中的 childVisual 的父级。

[in] childVisual

要添加的内容的组合树中的子视觉对象。

parentVisual 还必须是合成树中的 childVisual 的父级。

返回值

如果方法成功，则返回 S_OK。否则，将返回 HRESULT 错误代码。

注解

此方法在父Visual 和子Visual之间插入一个直接操作设备拥有 () 的小型可视化树。然后，可以将转换应用于插入的内容。

所有内容（无论类型如何）都必须添加到合成器。

如果应用程序使用系统提供的 IDirectManipulationCompositor：

device 必须是 IDCompositionDevice 对象，父视觉对象和子视觉对象必须是 IDCompositionVisual 对象。
device、 parentVisual 和 childVisual 不能为 NULL。
device、 parentVisual 和 childVisual 对象由应用程序创建和拥有。
使用此方法将内容添加到合成树时，将在 parentVisual 和 childVisual 之间插入新的合成视觉对象。在使用 RemoveContent 取消与合成器关联之前，不应销毁新视觉对象。

如果应用程序使用 IDirectManipulationCompositor 的自定义实现：

device、 parentVisual 和 childVisual 必须是合成器的有效类型。它们不必是 IDCompositionDevice 或 IDCompositionVisual 对象。
device、 parentVisual 和 childVisual 可以为 NULL，具体取决于合成器。