KSEVENT_CAMERAEVENT 枚举 (ksmedia.h)

KSEVENT_CAMERAEVENT 枚举一个内核流事件集，管道可以使用该事件集来启用或禁用来自驱动程序的相机事件通知。

语法

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

常量

注解

相机事件 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事件通知。

要求