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