다음을 통해 공유

IDCompositionVisual::SetContent 메서드(dcomp.h)

  • 아티클

이 시각적 개체의 Content 속성을 지정된 비트맵 또는 창 래퍼로 설정합니다.

구문

HRESULT SetContent(
  [in, optional] IUnknown *content
);

매개 변수

[in, optional] content

형식: IUnknown*

이 시각적 개체의 새 콘텐츠인 개체입니다. 이 매개 변수는 NULL일 수 있습니다.

반환 값

형식: HRESULT

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

설명

콘텐츠 매개 변수는 다음 중 하나를 가리킵니다.

새 콘텐츠는 이전에 시각적 개체와 연결된 모든 콘텐츠를 대체합니다. 콘텐츠 매개 변수가 NULL이면 시각적 개체에 연결된 콘텐츠가 없습니다.

시각적 개체는 비트맵 개체 또는 창 래퍼와 연결할 수 있습니다. 비트맵은 Microsoft DirectX 스왑 체인 또는 Microsoft DirectComposition 표면입니다.

창 래퍼는 CreateSurfaceFromHwnd 메서드를 사용하여 만들어지며 최상위 창 또는 계층화된 자식 창이어야 하는 다른 창의 래스터화를 위한 스탠드인입니다. 창 래퍼는 개념적으로 창 내용이 그려지는 대상 창의 크기인 비트맵과 동일합니다. 콘텐츠에는 대상 창의 자식 창(계층화 또는 기타)과 자식 창에 그려진 DirectComposition 콘텐츠가 포함됩니다.

DirectComposition 표면 래퍼는 CreateSurfaceFromHandle 메서드를 사용하여 만들어지고 스왑 체인에 대한 참조입니다. 애플리케이션은 한 프로세스가 스왑 체인을 만들고 다른 프로세스가 비트맵을 시각적 개체와 연결하는 크로스 프로세스 시나리오에서 표면 래퍼를 사용할 수 있습니다.

비트맵은 시각적 개체의 좌표계를 기준으로 항상 위치(0,0)에 그려지지만 좌표계는 OffsetX, OffsetY 및 Transform 속성의 직접적인 영향을 받으며 상위 시각적 개체의 변환에 의해 간접적으로 영향을 받습니다. 시각적 개체의 비트맵은 항상 해당 시각적 개체의 자식 뒤에 그려집니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2012 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 dcomp.h
라이브러리 Dcomp.lib
DLL Dcomp.dll

추가 정보

IDCompositionVisual

IDXGIFactory2::CreateSwapChain1