Share via

перечисление KSEVENT_CAMERAEVENT (ksmedia.h)

  • Статья

KSEVENT_CAMERAEVENT перечисляет набор событий потоковой передачи ядра, который может использоваться конвейером для включения или отключения уведомлений о событиях камеры от драйвера.

Синтаксис

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