다음을 통해 공유

KSEVENT_CAMERAEVENT 열거형(ksmedia.h)

  • 아티클

KSEVENT_CAMERAEVENT 드라이버에서 카메라 이벤트 알림을 사용하거나 사용하지 않도록 설정하는 데 파이프라인에서 사용할 수 있는 커널 스트리밍 이벤트 집합을 열거합니다.

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

상수

 
KSEVENT_PHOTO_SAMPLE_SCANNED
사진 캡처를 위해 셔터 사운드 재생을 동기화하는 이벤트 알림입니다.

설명

카메라 이벤트 DDI는 드라이버에서 카메라 이벤트 알림을 사용하거나 사용하지 않도록 설정하는 데 파이프라인에서 사용할 수 있는 커널 스트리밍 이벤트 집합인 KSEVENTSETID_CameraEvent 정의됩니다. 이는 드라이버가 필터의 자동화 테이블에서 이벤트를 구현 및 정의하고 KsFilterGenerateEvents (또는 필터 개체가 있는 KsGenerateEvents )를 사용하여 이벤트 알림을 생성해야 한다는 것을 의미하는 필터 수준 이벤트입니다.

KSEVENTSETID_CameraEvent 및 관련 데이터 구조는 다음과 같이 Ksmedia.h에 정의됩니다.

#define STATIC_KSEVENTSETID_CameraEvent \
    0x7899b2e0, 0x6b43, 0x4964, 0x9d, 0x2a, 0xa2, 0x1f, 0x40, 0x61, 0xf5, 0x76

DEFINE_GUIDSTRUCT("7899B2E0-6B43-4964-9D2A-A21F4061F576", KSEVENTSETID_CameraEvent);

#define KSEVENTSETID_CameraEvent DEFINE_GUIDNAMED(KSEVENTSETID_CameraEvent)

현재 KSEVENTSETID_CameraEvent 이벤트 집합에 대해 KSEVENT_PHOTO_SAMPLE_SCANNED 이벤트만 정의됩니다. 파이프라인은 KSEVENT_PHOTO_SAMPLE_SCANNED 이벤트 알림을 구독하고 수신 대기하여 사진 캡처를 위한 셔터 사운드 재생을 동기화합니다. 파이프라인은 지정된 사진 캡처 또는 사진 시퀀스에 대한 첫 번째 KSEVENT_PHOTO_SAMPLE_SCANNED 이벤트 알림에만 응답합니다. 단일 사진 캡처 또는 사진 시퀀스 캡처에 대해 셔터 소리를 한 번만 재생하고 사진 또는 사진 시퀀스 캡처가 완료되거나 중지될 때까지 후속 알림을 무시합니다.

이 이벤트 집합은 선택 사항입니다. 드라이버가 이벤트 집합을 구현하지 않으면 DevProxy에서 사진 캡처의 첫 번째 사진 샘플을 수신할 때 파이프라인은 기본적으로 셔터 사운드 재생으로 설정됩니다.

드라이버가 이 이벤트 집합을 구현하는 경우 파이프라인은 이벤트에만 응답하고 사진 샘플을 받을 때 셔터 사운드를 생성하지 않습니다. 따라서 드라이버가 이 이벤트 집합의 지원을 구현하는 경우 사진 샘플을 검사할 때 드라이버에서 KSEVENT_PHOTO_SAMPLE_SCANNED 이벤트 알림이 생성되도록 하는 것이 중요합니다.

요구 사항

요구 사항 값
헤더 ksmedia.h