CompositionTarget 클래스

정의

네임스페이스:

Windows.UI.Xaml.Media

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

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.CompositionTarget(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

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 IInspectable CompositionTarget

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

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

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

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

• regenerating custom visual content on screen in response to the SurfaceContentsLost event, for example regenerating a RenderTargetBitmap or DirectX interop content in a SurfaceImageSource

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

버전 기록

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

이벤트

Rendered	코어 렌더링 프로세스가 프레임을 렌더링한 직후에 발생합니다. 이 이벤트를 통해 각 프레임을 렌더링하는 데 걸리는 시간을 결정할 수 있습니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.CompositionTarget.Rendered(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Rendering	코어 렌더링 프로세스가 프레임을 렌더링할 때 발생합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.CompositionTarget.Rendering(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
SurfaceContentsLost	DirectX 디바이스 변경과 같은 기본 주요 변경이 발생할 때 발생합니다. 일반적으로 애플리케이션은 이 이벤트에 대한 알림을 받을 때 표면 콘텐츠를 다시 생성해야 합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.CompositionTarget.SurfaceContentsLost(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

추가 정보

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