KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S 구조체(ksmedia.h)
PROPSETID_VIDCAP_CAMERACONTROL_REGION_OF_INTEREST 카메라 컨트롤 속성 집합의 ROI(관심 영역) 컨트롤 속성에 대해 설명합니다. 관심 영역은 카메라에 초점을 맞추는 데 사용되는 이미지의 사각형입니다. 이 구조체는 카메라 드라이버에 대한 요청에 사용되는 속성 값을 지정합니다.
구문
typedef struct {
RECT FocusRect;
BOOL AutoFocusLock;
BOOL AutoExposureLock;
BOOL AutoWhitebalanceLock;
union {
ULONG Capabilities;
ULONG Configuration;
};
} KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S, *PKSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_S;
멤버
FocusRect
디바이스가 포커스를 설정해야 하는 사각형 영역을 지정하는 RECT 구조체입니다. 이 구조는 Windows 앱에서만 사용할 수 있습니다.
FocusRect가 유효한 값이 아니거나 RECT 구조체의 모든 멤버가 0인 경우 디바이스는 이미지의 중심을 집중해야 하며 이 구조체의 나머지 멤버는 무시할 수 있습니다.
사각형의 좌표는 미리 보기 비디오 해상도와 관련이 있습니다.
AutoFocusLock
TRUE이면 디바이스가 포커스를 현재 값으로 잠급니다.
FocusRect가 유효한 값이 아닌 경우 이 멤버를 무시해야 합니다.
AutoExposureLock
TRUE이면 디바이스가 현재 값에 대한 노출을 잠급니다.
FocusRect가 유효한 값이 아닌 경우 이 멤버를 무시해야 합니다.
AutoWhitebalanceLock
TRUE이면 디바이스가 화이트 밸런스 설정을 현재 값으로 잠급니다.
FocusRect가 유효한 값이 아닌 경우 이 멤버를 무시해야 합니다.
Capabilities
디바이스와 드라이버가 관심 영역 설정을 자동으로 또는 수동으로 설정할 수 있는지 여부를 나타냅니다. 이 멤버는 다음과 같은 가능한 값의 비트 OR 입니다.
값 | 의미 |
---|---|
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_AUTO | 디바이스와 드라이버는 관심 영역을 자동으로 설정할 수 있습니다. |
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_MANUAL | 사용자는 관심 영역을 수동으로 설정할 수 있습니다. |
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_FLAGS_ASYNC | ROI 컨트롤 기능은 비동기적으로 실행됩니다. 이 기능은 Windows 8.1 부터 사용할 수 있습니다. |
Configuration
지역의 제어 작업에 대한 구성 플래그입니다. 다음 값의 비트 OR 조합입니다.
이 멤버는 Windows 8.1 부터 사용할 수 있습니다.
값 | 의미 |
---|---|
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_FOCUS | 지역에 대한 자동 포커스를 설정합니다. |
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_EXPOSURE | 지역에 대한 자동 노출을 설정합니다. |
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONFIG_WB | 지역에 대한 자동 흰색 균형을 설정합니다. |
KSPROPERTY_CAMERACONTROL_REGION_OF_INTEREST_CONVERGEMODE | 지역에서 개체의 수렴을 사용하도록 설정합니다. |
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows 8 |
지원되는 최소 서버 | Windows Server 2012 |
머리글 | ksmedia.h(Ksmedia.h 포함) |