IDCompositionTarget::SetRoot 메서드(dcomp.h)

시각적 개체를 시각적 트리의 새 루트 개체로 설정합니다.

구문

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

[in, optional] visual

이 시각적 트리의 새 루트인 시각적 개체입니다. 이 매개 변수는 NULL일 수 있습니다.

형식: HRESULT

함수가 성공하면 S_OK를 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다. 오류 코드 목록은 DirectComposition 오류 코드를 참조하세요.

시각적 개체는 단일 시각적 트리의 루트 또는 다른 시각적 개체의 자식일 수 있지만 동시에 둘 다 될 수는 없습니다. 시각적 매개 변수가 이미 다른 시각적 트리의 루트이거나 다른 시각적 개체의 자식인 경우 이 메서드는 실패합니다.

시각적 개체가 NULL이면 시각적 트리가 비어 있습니다. NULL이 아닌 이전 루트 시각적 개체가 있는 경우 해당 시각적 개체는 다른 시각적 트리의 루트 또는 다른 시각적 개체의 자식으로 사용할 수 있게 됩니다.