다음을 통해 공유

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