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

특성

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

구현

IMediaDeviceController

Windows 요구 사항

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

설명

이 개체의 인스턴스를 얻으려면 속성을 검색합니다 MediaCapture.VideoDeviceController .

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

참고

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

버전 기록

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	ExposurePriorityVideoControl와 연결된 VideoDeviceController를 가져옵니다.
FlashControl	이 비디오 디바이스에 대한 플래시 컨트롤을 가져옵니다.
Focus	카메라의 MediaDeviceControl 포커스 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
FocusControl	이 비디오 디바이스에 대한 포커스 컨트롤을 가져옵니다.
HdrVideoControl	HdrVideoControl와 연결된 VideoDeviceController를 가져옵니다. 이를 통해 HDR(High Dynamic Range) 비디오 캡처 모드를 지원하는 디바이스에서 사용하거나 사용하지 않도록 설정할 수 있습니다.
Hue	MediaDeviceControl 카메라의 색조 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
Id	비디오 디바이스 컨트롤러의 식별자가 포함된 문자열을 가져옵니다.
InfraredTorchControl	선택한 비디오 디바이스에 대한 적외선 토치 컨트롤을 가져옵니다.
IsoSpeedControl	이 비디오 디바이스에 대한 ISO 필름 속도 제어를 가져옵니다.
LowLagPhoto	이 비디오 디바이스에 대한 낮은 셔터 지연 사진 컨트롤을 가져옵니다.
LowLagPhotoSequence	이 비디오 디바이스에 대한 낮은 셔터 지연 사진 시퀀스 컨트롤을 가져옵니다.
OpticalImageStabilizationControl	OpticalImageStabilizationControl와 연결된 VideoDeviceController를 가져옵니다.
Pan	MediaDeviceControl 카메라의 팬 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
PanelBasedOptimizationControl	PanelBasedOptimizationControl 지원되는 경우 앱에서 캡처 디바이스 드라이버가 카메라의 패널 위치에 따라 카메라 캡처 기능을 최적화할 수 있도록 허용합니다.
PhotoConfirmationControl	이 비디오 장치의 사진 확인 컨트롤을 가져옵니다.
PrimaryUse	디바이스에 대한 기본 사용을 가져오거나 설정합니다.
RegionsOfInterestControl	이 비디오 디바이스에 대한 관심 있는 컨트롤 영역을 가져옵니다.
Roll	MediaDeviceControl 카메라의 롤 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
SceneModeControl	이 비디오 디바이스의 장면 모드 컨트롤을 가져옵니다.
Tilt	MediaDeviceControl 카메라의 기울기 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
TorchControl	이 비디오 디바이스에 대한 토치 컨트롤을 가져옵니다.
VariablePhotoSequenceController	에 연결된 VariablePhotoSequenceController를 VideoDeviceController가져옵니다.
VideoTemporalDenoisingControl	VideoTemporalDenoisingControl와 연결된 VideoDeviceController를 가져옵니다. 이를 통해 인접한 프레임의 이미지 데이터를 사용하여 이를 지원하는 디바이스에서 캡처된 비디오의 노이즈 모양을 줄이는 임시 디노이징을 사용하도록 설정하고 사용하지 않도록 설정할 수 있습니다.
WhiteBalance	카메라의 MediaDeviceControl 흰색 균형을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
WhiteBalanceControl	이 비디오 디바이스에 대한 화이트 밸런스 컨트롤을 가져옵니다.
Zoom	카메라의 MediaDeviceControl 확대/축소 설정을 가져오거나 설정하는 데 사용할 수 있는 개체를 가져옵니다.
ZoomControl	ZoomControl와 연결된 VideoDeviceController를 가져옵니다.

메서드

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)	로컬 전력선 주파수를 설정합니다.

추가 정보

• 램프 디바이스 샘플