CompositionTarget 클래스

정의

네임스페이스:

Windows.UI.Xaml.Media

앱의 복합 디스플레이 화면을 나타냅니다. 이 클래스는 애플리케이션 전체 렌더링 이벤트를 제공합니다.

public ref class CompositionTarget sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class CompositionTarget final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class CompositionTarget

Public NotInheritable Class CompositionTarget

상속

Object Platform::Object IInspectable CompositionTarget

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

설명

CompositionTarget 이벤트는 다음과 같은 렌더링 시나리오에 유용합니다.

• Rendering 이벤트를 사용하여 DirectX interop 렌더링 동기화

• Rendered 이벤트를 사용하여 프레임 렌더링 시간 측정

• SurfaceContentsLost 이벤트에 대한 응답으로 화면에 사용자 지정 시각적 콘텐츠 다시 생성(예: SurfaceImageSource에서 RenderTargetBitmap 또는 DirectX interop 콘텐츠 다시 생성)

사용자 지정 렌더링 또는 프레임 시간 측정을 포함하지 않는 시나리오의 경우 CompositionTarget이 필요하지 않으며 모든 컴퍼지션 및 레이아웃을 실행하고 수행하는 XAML 렌더링 시스템에만 의존할 수 있습니다.

버전 기록

Windows 버전	SDK 버전	추가된 값
1803	17134	렌더링됨

이벤트

Rendered	코어 렌더링 프로세스가 프레임을 렌더링한 직후에 발생합니다. 이 이벤트를 사용하면 각 프레임이 렌더링하는 데 걸리는 시간을 결정할 수 있습니다.
Rendering	코어 렌더링 프로세스가 프레임을 렌더링할 때 발생합니다.
SurfaceContentsLost	DirectX 디바이스 변경과 같은 기본 주요 변경이 발생할 때 발생합니다. 일반적으로 애플리케이션은 이 이벤트에 대한 알림을 받으면 표면 콘텐츠를 다시 생성해야 합니다.

추가 정보

• DirectX 및 XAML interop
• 애니메이션 및 미디어 최적화