IDirectManipulationCompositor2::AddContentWithCrossProcessChaining メソッド (directmanipulation.h)

[アーティクル]
08/23/2023

(コンポーネントホストが所有する) コンテンツをコンポジターに関連付け、コンポジションデバイスをコンテンツに割り当て、他のコンポジションビジュアルに対するコンポジションツリー内のコンテンツの位置を指定します。操作されたコンテンツを複数のプロセスにわたって描画サーフェスに関連付けるコンポジターオブジェクトを表します。

構文

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 エラーコードを返します。

注釈

このメソッドは、parentVisual と childVisual の間に小さなビジュアルツリー (直接操作デバイスが所有) を挿入します。その後、挿入されたコンテンツに変換を適用できます。

種類に関係なく、すべてのコンテンツをコンポジターに追加する必要があります。

アプリケーションでシステム提供の IDirectManipulationCompositor を使用する場合:

device は IDCompositionDevice オブジェクトである必要があり、親ビジュアルと子ビジュアルは IDCompositionVisual オブジェクトである必要があります。
device、 parentVisual、 childVisual を NULL にすることはできません。
device、 parentVisual、 childVisual オブジェクトは、アプリケーションによって作成および所有されます。
このメソッドを使用してコンポジションツリーにコンテンツを追加すると、 parentVisual と childVisual の間に新しいコンポジション ビジュアルが挿入されます。新しいビジュアルは、 RemoveContent とコンポジターとの関連付けが解除されるまで破棄しないでください。

アプリケーションで IDirectManipulationCompositor のカスタム実装を使用する場合:

device、 parentVisual、および childVisual は、コンポジターの有効な型である必要があります。 IDCompositionDevice オブジェクトまたは IDCompositionVisual オブジェクトである必要はありません。
device、 parentVisual、 childVisual は、コンポジターに応じて NULL にすることができます。