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 은 컴퍼지션 트리에서 자식Visual 의 부모여야 합니다.

[in] childVisual

추가되는 콘텐츠의 컴퍼지션 트리에 있는 자식 시각적 개체입니다.

parentVisual 은 컴퍼지션 트리에서 자식Visual 의 부모여야 합니다.

반환 값

메서드가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

이 메서드는 부모Visual과 자식Visual 사이에 작은 시각적 트리(직접 조작 디바이스 소유)를 삽입합니다. 그런 다음 삽입된 콘텐츠에 변환을 적용할 수 있습니다.

형식에 관계없이 모든 콘텐츠를 작성자에 추가해야 합니다.

애플리케이션에서 시스템 제공 IDirectManipulationCompositor를 사용하는 경우:

디바이스 는 IDCompositionDevice 개체여야 하며 부모 및 자식 시각적 개체는 IDCompositionVisual 개체여야 합니다.
device, parentVisual 및 childVisual 은 NULL일 수 없습니다.
device, parentVisual 및 childVisual 개체는 애플리케이션에서 만들고 소유합니다.
이 메서드를 사용하여 콘텐츠가 컴퍼지션 트리에 추가되면 parentVisual 과 childVisual 사이에 새 컴퍼지션 시각적 개체가 삽입됩니다. 새 시각적 개체는 RemoveContent를 사용하여 작성기에서 분리될 때까지 제거하면 안 됩니다.

애플리케이션에서 IDirectManipulationCompositor의 사용자 지정 구현을 사용하는 경우:

device, parentVisual 및 childVisual 은 작성자에 유효한 형식이어야 합니다. IDCompositionDevice 또는 IDCompositionVisual 개체일 필요는 없습니다.
device, parentVisual 및 childVisual 은 작성자에 따라 NULL일 수 있습니다.