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 포함)

참고 항목

KSPROPERTY_CAMERACONTROL_FLASH_PROPERTY

RECT