KSPROPERTY_CAMERACONTROL_EXTENDED_IRTORCHMODE

  • 아티클

이 확장된 속성 제어는 클라이언트가 IR 카메라의 적외선 토치 전원 수준 및 의무 주기를 제어하는 데 사용됩니다. 표준 KSCAMERA_EXTENDEDPROP_HEADER 구조와 함께 드라이버에 전송되고 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조가 뒤따릅니다.

사용 요약 테이블

Get Set 대상 속성 설명자 형식 속성 값 형식
Yes Yes 필터 KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

설명

속성 요청에는 KSCAMERA_EXTENDEDPROP_HEADER 구조와 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조가 포함됩니다.

총 속성 데이터 크기는 sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)입니다. KSCAMERA_EXTENDEDPROP_HEADERSize 멤버는 이 총 속성 데이터 크기로 설정됩니다.

다음은 KSCAMERA_EXTENDEDPROP_HEADER 배치할 수 있는 플래그입니다 . 플래그 및 KSCAMERA_EXTENDEDPROP_HEADER. 기능 필드. IR 토치의 작동 모드를 정의합니다.

토치 모드 Description
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF 끄기
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON Always On
KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATING_FRAME_ILLUMINATION 다른 모든 프레임에 대해 켜기

KSCAMERA_EXTENDEDPROP_IRTORCHMODE 항상 동기 컨트롤입니다. 카메라가 스트리밍되지 않을 때 컨트롤에 정의된 동작이 없습니다.

GET 요청의 경우 드라이버는 다음 필드를 설정합니다.

  • KSCAMERA_EXTENDEDPROP_HEADER. 위의 비트 마스크가 있는 기능KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 플래그는 카메라에서 지원하는 작동 모드를 나타냅니다.
  • KSCAMERA_EXTENDEDPROP_HEADER. 위의 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_XXX 플래그 중 하나에 플래그를 지정하여 현재 작동 모드를 나타냅니다.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. 모드 를 0으로 설정합니다.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. 사용 가능한 최소 전원 수준까지 최소입니다.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. 최대 최대 사용 가능한 전원 수준까지.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. 전원 수준 사이의 최소 증분까지 단계별로 실행합니다.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul 을 현재 전원 수준까지. 이 값은 기본적으로 얼굴 인증 컨트롤에서 일반적으로 사용하는 것과 동일한 전원 수준으로 설정되어야 합니다.

SET 요청의 경우 드라이버는 다음 필드를 사용합니다.

  • KSCAMERA_EXTENDEDPROP_HEADER. 작동 모드를 설정하는 플래그입니다.
  • KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING. VideoProc.ul - 전원 수준을 설정합니다. 이 값은 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF 영향을 주지 않습니다.

아래 표에는 메타데이터 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_HEADER 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

버전

1이어야 합니다.

PinId

KSCAMERA_EXTENDEDPROP_FILTERSCOPE(0xFFFFFFFF).

크기

sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof([KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING](/windows-hardware/drivers/ddi/ksmedia/ns-ksmedia-tagkscamera_extendedprop_videoprocsetting))여야 합니다.

결과

이 값은 동기 컨트롤에 대해 무시됩니다.

기능

KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF, KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON또는KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION 조합될 수 있습니다. 이 필드는 하나 이상의 기능을 보고해야 합니다. 필드는 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON 또는 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION 또는 둘 다 보고해야 합니다. KSCAMERA_EXTENDEDPROP_IRTORCHMODE_OFF 값은 선택 사항입니다.

플래그

접근 권한 값에 보고된 플래그 중 하나여야 합니다. 기본값은 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALWAYS_ON 또는 KSCAMERA_EXTENDEDPROP_IRTORCHMODE_ALTERNATIVE_FRAME_ILLUMINATION 이어야 합니다.

아래 표에는 IR 토치 모드 컨트롤을 사용할 때 KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING 구조 필드에 대한 설명과 요구 사항이 포함되어 있습니다.

멤버 Description

Mode

사용되지 않습니다. 0이어야 합니다.

최소/최대/단계

최소/최대/단계에는 IR 전원 설정의 최소/최대/증가가 포함됩니다. 드라이버는 GET 작업에 대해 이를 반환해야 합니다. (최대 – 최소)는 단계별로 균등하게 나눌 수 있어야 합니다. 단계는 0이 아닐 수 있습니다.

VideoProc

SET 작업의 경우 VideoProc.Value.ul은 Min/Max/Step 매개 변수에 설명된 범위 내에서 전원 수준을 지정해야 합니다. GET 작업의 경우 드라이버는 현재 전원 수준을 반환해야 합니다.

예약됨

사용되지 않습니다. 드라이버에서 무시해야 합니다.

요구 사항

헤더

 Ksmedia.h