IDCompositionDesktopDevice::CreateTargetForHwnd 메서드(dcomp.h)

지정된 창 핸들로 표시되는 창에 바인딩된 컴퍼지션 대상 개체를 만듭니다.

구문

HRESULT CreateTargetForHwnd(
  [in]  HWND                hwnd,
        BOOL                topmost,
  [out] IDCompositionTarget **target
);

매개 변수

[in] hwnd

컴퍼지션 대상 개체를 바인딩해야 하는 창입니다. 이 매개 변수는 NULL이 아니어야 합니다.

topmost

TRUE이면 hwnd 매개 변수로 지정된 창의 자식 위에 시각적 트리를 표시해야 합니다. 그렇지 않으면 시각적 트리가 자식 뒤에 표시됩니다.

[out] target

새 컴퍼지션 대상 개체입니다. 이 매개 변수는 NULL이 아니어야 합니다.

반환 값

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

설명

화면에 표시하려면 DirectComposition 시각적 트리를 창에 바인딩해야 합니다. 창은 최상위 창 또는 자식 창일 수 있습니다. 두 경우 모두 창은 계층화된 창일 수 있지만 모든 경우에 창은 호출 프로세스에 속해야 합니다. 창이 다른 프로세스에 속하는 경우 이 메서드는 DCOMPOSITION_ERROR_ACCESS_DENIED 반환합니다.

DirectComposition 콘텐츠가 창에 구성된 경우 콘텐츠는 GetDC 함수에서 반환된 디바이스 컨텍스트 또는 DirectX Present 메서드 호출을 통해 해당 창에 직접 그려지는 내용 위에 항상 구성됩니다. 그러나 창 클리핑 규칙이 DirectComposition 콘텐츠에 적용되므로 창에 자식 창이 있는 경우 해당 자식 창이 시각적 트리를 클리핑할 수 있습니다. 맨 위 매개 변수는 자식 창이 시각적 트리를 클리핑하는지 여부를 결정합니다.

개념적으로 각 창은 다음 네 개의 레이어로 구성됩니다.

1. 창 핸들에 직접 그린 내용입니다(맨 아래 레이어임).
2. 선택적 DirectComposition 시각적 트리입니다.
3. 모든 자식 창의 내용(있는 경우)입니다.
4. 또 다른 선택적 DirectComposition 시각적 트리(최상위 계층임).

네 개의 레이어가 모두 창의 표시되는 영역으로 잘립니다.

최대 두 개의 컴퍼지션 대상만 시스템의 각 창에 대해 만들 수 있습니다. 하나는 맨 위이고 다른 하나는 맨 위가 아닙니다. 컴퍼지션 대상이 지정된 계층의 지정된 창에 이미 바인딩된 경우 이 메서드는 실패합니다. 컴퍼지션 대상 개체가 제거되면 구성한 레이어를 새 컴퍼지션 대상 개체에서 사용할 수 있습니다.

요구 사항

요구 사항	값
대상 플랫폼	Windows
헤더	dcomp.h

추가 정보

IDCompositionDesktopDevice

IDCompositionVisual2