VideoDeviceController 클래스

정의

네임스페이스:

Windows.Media.Devices

카메라의 디바이스 설정을 제어합니다.

public ref class VideoDeviceController sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
class VideoDeviceController final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.MTA)]
public sealed class VideoDeviceController

Public NotInheritable Class VideoDeviceController

상속

Object Platform::Object IInspectable VideoDeviceController

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IMediaDeviceController

Windows 요구 사항

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

설명

이 개체의 instance 얻으려면 MediaCapture.VideoDeviceController 속성을 검색합니다.

일부 드라이버는 VideoDeviceController에서 지원되는 컨트롤을 결정하기 전에 카메라 디바이스 미리 보기가 실행 중 상태여야 할 수 있습니다. 미리 보기 스트림이 실행되기 전에 VideoDeviceController에서 특정 컨트롤을 지원하는지 여부를 검사 경우 비디오 디바이스에서 지원되더라도 컨트롤이 지원되지 않는 것으로 설명될 수 있습니다.

참고

이 클래스는 민첩하지 않으므로 스레딩 모델 및 마샬링 동작을 고려해야 합니다. 자세한 내용은 스레딩 및 마샬링(C++/CX) 및 다중 스레드 환경에서 Windows 런타임 개체 사용(.NET)을 참조하세요.

버전 기록

Windows 버전	SDK 버전	추가된 값
1703	15063	GetDevicePropertyByExtendedId
1703	15063	GetDevicePropertyById
1703	15063	Id
1703	15063	SetDevicePropertyByExtendedId
1703	15063	SetDevicePropertyById
1803	17134	VideoTemporalDenoisingControl
1903	18362	InfraredTorchControl
2004	19041	PanelBasedOptimizationControl

속성

AdvancedPhotoControl	이 비디오 디바이스에 대한 고급 사진 캡처 컨트롤을 가져옵니다.
BacklightCompensation	카메라에서 백라이트 보정을 사용할지 여부를 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
Brightness	카메라의 밝기 수준을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
CameraOcclusionInfo	카메라의 현재 폐색 상태를 가져오고 폐색 상태가 변경될 때 알림을 받는 데 사용할 수 있는 CameraOcclusionInfo 개체를 가져옵니다.
Contrast	카메라의 대비 수준을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
DesiredOptimization	비디오 캡처 중에 캡처 디바이스가 고품질 그림, 짧은 대기 시간 또는 낮은 전력 소비량의 우선 순위를 지정하는 데 사용해야 하는 최적화를 나타내는 값을 가져오거나 설정합니다.
DigitalWindowControl	앱이 캡처 디바이스 센서의 하위 리소스를 캡처할 수 있도록 하는 DigitalWindowControl 을 가져옵니다.
Exposure	카메라의 노출 시간을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
ExposureCompensationControl	이 비디오 디바이스에 대한 노출 보정 컨트롤을 가져옵니다.
ExposureControl	이 비디오 디바이스에 대한 노출 제어를 가져옵니다.
ExposurePriorityVideoControl	VideoDeviceController와 연결된 ExposurePriorityVideoControl을 가져옵니다.
FlashControl	이 비디오 디바이스에 대한 플래시 컨트롤을 가져옵니다.
Focus	카메라의 포커스 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
FocusControl	이 비디오 디바이스에 대한 포커스 컨트롤을 가져옵니다.
HdrVideoControl	VideoDeviceController와 연결된 HdrVideoControl을 가져옵니다. 이를 통해 HDR(High Dynamic Range) 비디오 캡처 모드를 지원하는 디바이스에서 사용하거나 사용하지 않도록 설정할 수 있습니다.
Hue	카메라의 색조 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
Id	비디오 디바이스 컨트롤러의 식별자를 포함하는 문자열을 가져옵니다.
InfraredTorchControl	선택한 비디오 디바이스에 대한 적외선 토치 컨트롤을 가져옵니다.
IsoSpeedControl	이 비디오 디바이스에 대한 ISO 필름 속도 제어를 가져옵니다.
LowLagPhoto	이 비디오 장치의 낮은 셔터 지연 사진 컨트롤을 가져옵니다.
LowLagPhotoSequence	이 비디오 디바이스에 대한 낮은 셔터 지연 사진 시퀀스 컨트롤을 가져옵니다.
OpticalImageStabilizationControl	VideoDeviceController와 연결된 OpticalImageStabilizationControl을 가져옵니다.
Pan	카메라의 팬 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
PanelBasedOptimizationControl	지원되는 경우 앱이 카메라의 패널 위치에 따라 카메라 캡처 기능을 최적화할 수 있도록 하는 PanelBasedOptimizationControl 을 가져옵니다.
PhotoConfirmationControl	이 비디오 디바이스에 대한 사진 확인 컨트롤을 가져옵니다.
PrimaryUse	디바이스의 기본 사용을 가져오거나 설정합니다.
RegionsOfInterestControl	이 비디오 디바이스에 대한 관심 영역 컨트롤을 가져옵니다.
Roll	카메라의 롤 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
SceneModeControl	이 비디오 디바이스의 장면 모드 컨트롤을 가져옵니다.
Tilt	카메라의 기울기 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
TorchControl	이 비디오 디바이스에 대한 토치 컨트롤을 가져옵니다.
VariablePhotoSequenceController	VideoDeviceController와 연결된 VariablePhotoSequenceController를 가져옵니다.
VideoTemporalDenoisingControl	VideoDeviceController와 연결된 VideoTemporalDenoisingControl을 가져옵니다. 이를 통해 인접한 프레임의 이미지 데이터를 사용하여 캡처된 비디오의 노이즈를 지원하는 디바이스에서 노이즈 모양을 줄이는 임시 디노이징을 사용하도록 설정하고 사용하지 않도록 설정할 수 있습니다.
WhiteBalance	카메라의 흰색 균형을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
WhiteBalanceControl	이 비디오 디바이스에 대한 화이트 밸런스 컨트롤을 가져옵니다.
Zoom	카메라의 확대/축소 설정을 가져오거나 설정하는 데 사용할 수 있는 MediaDeviceControl 개체를 가져옵니다.
ZoomControl	VideoDeviceController와 연결된 ZoomControl을 가져옵니다.

메서드

GetAvailableMediaStreamProperties(MediaStreamType)	비디오 디바이스에 대해 지원되는 인코딩 속성의 목록을 가져옵니다.
GetDeviceProperty(String)	캡처 디바이스 드라이버에서 지정된 ID를 가진 속성의 값을 가져옵니다. 이 메서드를 사용하여 특정 카메라와 관련된 속성을 쿼리할 수 있습니다.
GetDevicePropertyByExtendedId(Byte[], IReference<UInt32>)	사용자 지정 헤더 정보가 있는 확장 ID를 사용하고 결과를 저장하는 데 필요한 최대 버퍼 크기를 지정하여 캡처 디바이스 드라이버에서 지정된 ID를 가진 속성 값을 가져옵니다. 이 메서드를 사용하여 특정 카메라와 관련된 속성을 쿼리할 수 있습니다.
GetDevicePropertyById(String, IReference<UInt32>)	사용자 지정 헤더 정보가 있는 ID를 사용하여 캡처 디바이스 드라이버에서 속성 값을 가져옵니다. 이 메서드를 사용하여 특정 카메라와 관련된 속성을 쿼리할 수 있습니다.
GetMediaStreamProperties(MediaStreamType)	비디오 디바이스의 지정된 미디어 스트림 유형에 대한 인코딩 속성을 가져옵니다.
SetDeviceProperty(String, Object)	캡처 디바이스 드라이버에서 지정된 ID를 사용하여 속성의 값을 설정합니다. 이 메서드를 사용하여 특정 카메라와 관련된 속성을 설정할 수 있습니다.
SetDevicePropertyByExtendedId(Byte[], Byte[])	사용자 지정 헤더 정보가 있는 확장 ID를 사용하고 값을 바이트 배열로 제공하여 캡처 디바이스 드라이버에서 지정된 ID로 속성 값을 설정합니다.
SetDevicePropertyById(String, Object)	사용자 지정 헤더 정보가 있는 확장 ID를 사용하고 값을 개체로 제공하여 캡처 디바이스 드라이버에서 지정된 ID로 속성 값을 설정합니다.
SetMediaStreamPropertiesAsync(MediaStreamType, IMediaEncodingProperties)	비디오 디바이스에 대해 지정된 미디어 스트림 유형에 대한 인코딩 속성을 비동기적으로 설정합니다.
TryAcquireExclusiveControl(String, MediaCaptureDeviceExclusiveControlReleaseMode)	지정된 디바이스 ID를 사용하여 카메라의 단독 제어를 요청합니다.
TryGetPowerlineFrequency(PowerlineFrequency)	로컬 전력선 주파수를 가져옵니다.
TrySetPowerlineFrequency(PowerlineFrequency)	로컬 전력선 주파수를 설정합니다.

추가 정보

• 램프 디바이스 샘플