KSPROPERTY_CAMERACONTROL_S_EX 구조체(ksmedia.h)

아티클
03/18/2023

플래시 설정, 이미지 핀 컨트롤 속성, 이미지에 관심 있는 영역 또는 비디오 손떨림 보정을 포함하여 카메라 컨트롤 작업을 지정합니다. 이 구조체는 PROPSETID_VIDCAP_CAMERACONTROL 속성 집합의 필터 기반 속성을 설명합니다.

Windows 8 부터 지원합니다.

구문

typedef struct {
  KSPROPERTY Property;
  LONG       Value;
  ULONG      Flags;
  ULONG      Capabilities;
  RECT       FocusRect;
} KSPROPERTY_CAMERACONTROL_S_EX, *PKSPROPERTY_CAMERACONTROL_S_EX;

멤버

Property

속성 집합, 속성 ID 및 요청 형식을 설명하는 초기화된 KSPROPERTY 구조를 지정합니다.

Value

속성의 값을 지정합니다. 이 멤버는 읽기/쓰기가 가능합니다.

Flags

가져오기 요청의 경우 아래 나열된 값에서 지정된 속성의 현재 설정을 나타냅니다. Set 요청의 경우 아래 나열된 값에서 지정된 속성에 대해 원하는 설정을 나타냅니다. 이 멤버는 Ksmedia.h에 정의된 다음 값 중 비트 OR일 수 있습니다.

값	Description
KSPROPERTY_CAMERACONTROL_FLAGS_AUTO	설정이 자동으로 제어됨을 나타냅니다. 드라이버가 이 값을 받으면 카메라 컨트롤을 동기적으로 자동 모드로 설정한 다음 반환해야 합니다.
KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL	설정이 수동으로 제어됨을 나타냅니다. 드라이버가 이 값을 받으면 카메라 컨트롤을 동기적으로 수동 모드로 설정한 다음 반환해야 합니다.
KSPROPERTY_CAMERACONTROL_FLAGS_ASYNCHRONOUS	드라이버가 카메라 컨트롤 작업을 비동기적으로 수행해야 하는지 여부를 나타냅니다. 여기서 애플리케이션은 사진을 찍기 전에 드라이버가 카메라 컨트롤 설정을 위한 명령을 실행했습니다. 이 플래그는 KSPROPERTY_CAMERACONTROL_FLAGS_MANUAL 또는 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 설정된 경우에만 설정해야 합니다. 이 플래그 값과 KSPROPERTY_CAMERACONTROL_FLAGS_AUTO 플래그 값이 모두 설정된 경우 드라이버는 작업자 스레드를 시작하여 요청된 컨트롤 작업을 시작해야 하며 첫 번째 작업이 완료될 때까지 동일한 작업에 대한 다른 모든 요청을 거부해야 합니다. 작업이 성공적으로 완료되면 드라이버는 KSEVENTSETID_CameraAsyncControl 이벤트를 트리거해야 합니다.