Поделиться через

перечисление 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