MediaCaptureVideoProfile 클래스

  • 참조

정의

네임스페이스:
Windows.Media.Capture
편집

비디오 캡처 디바이스에서 지원하는 구성을 나타내는 비디오 프로필을 나타냅니다.

public ref class MediaCaptureVideoProfile 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 MediaCaptureVideoProfile 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 MediaCaptureVideoProfile
Public NotInheritable Class MediaCaptureVideoProfile
상속
Object Platform::Object IInspectable MediaCaptureVideoProfile
특성
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

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

설명

비디오 프로필은 특정 캡처 디바이스에서 작동하도록 보장되고 원하는 캡처 시나리오에 최적화된 설정 그룹으로 비디오 캡처 디바이스를 구성하는 간단한 방법을 제공합니다. 시스템에서 고품질 사진 또는 비디오 캡처, 사진 시퀀스 캡처 또는 비디오 회의와 같은 일반적인 시나리오에 대해 제공하는 알려진 비디오 프로필 집합이 있습니다. 지정된 비디오 디바이스에 대해 알려진 비디오 프로필 목록을 얻으려면 MediaCapture.FindKnownVideoProfiles를 사용합니다. 일부 하드웨어 공급업체는 MediaCapture.FindAllVideoProfiles를 호출하여 얻을 수 있는 다른 비디오 프로필을 노출할 수 있습니다.

비디오 프로필은 MediaCaptureVideoProfileMediaDescription 개체, SupportedPhotoMediaDescription, SupportedPreviewMediaDescription 및 SupportedRecordMediaDescription의 세 가지 목록을 노출합니다. 이러한 목록의 각 항목은 해당 작업에 대해 지원되는 설정 그룹입니다. 예를 들어 단일 비디오 프로필은 HDR 비디오 지원을 통해 30fps에서 720p 비디오 녹화를 지원하고 HDR 비디오 지원 없이 30fps에서 1080p 비디오 녹화를 지원할 수도 있습니다. 이 경우 이러한 각 항목은 비디오 프로필의 SupportedRecordMediaDescription 목록에 있는 MediaCaptureVideoProfileMediaDescription 개체로 표시됩니다.

MediaCaptureInitializationSettings 개체를 사용하여 특정 비디오 프로필을 사용하도록 캡처 디바이스를 구성합니다. 디바이스를 구성할 때 사용하는 비디오 프로필이 다른 초기화 설정과 호환되는 것이 중요합니다. MediaCaptureInitializationSettings에서 미디어 프로필 설명을 올바르게 사용하는 방법에 대한 자세한 내용은 MediaCaptureInitializationSettings.VideoProfile을 참조하세요.

비디오 프로필을 사용하기 전에 MediaCapture.IsVideoProfileSupported에서 반환된 값을 검사 비디오 프로필이 캡처 디바이스에서 지원되는지 확인해야 합니다.

비디오 프로필 작업에 대한 방법 지침은 카메라 프로필을 사용하여 카메라 기능 검색 및 선택을 참조하세요.

버전 기록

Windows 버전 SDK 버전 추가된 값
1803 17134 FrameSourceInfos
1803 17134 속성

속성

FrameSourceInfos

MediaFrameSource의 기능에 대한 세부 정보를 제공하는 MediaFrameSourceInfo 개체의 읽기 전용 목록을 가져옵니다.
Id

비디오 프로필의 고유 식별자를 가져옵니다.
Properties

캡처 디바이스 제조업체에서 제공하는 사용자 지정 특성의 읽기 전용 맵을 가져옵니다.
SupportedPhotoMediaDescription

사진 캡처에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다.
SupportedPreviewMediaDescription

비디오 미리 보기에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다.
SupportedRecordMediaDescription

비디오 녹화에 지원되는 비디오 디바이스 설정을 나타내는 MediaCaptureVideoProfileMediaDescription 개체의 목록을 가져옵니다.
VideoDeviceId

비디오 프로필과 연결된 비디오 디바이스의 디바이스 ID를 가져옵니다.

메서드

GetConcurrency()

이 비디오 프로필과 동시에 사용할 수 있는 MediaCaptureVideoProfile 개체의 목록을 가져옵니다.

적용 대상

추가 정보