enumeración KSEVENT_CAMERAEVENT (ksmedia.h)

KSEVENT_CAMERAEVENT enumera un conjunto de eventos de streaming de kernel que puede usar la canalización para habilitar o deshabilitar las notificaciones de eventos de cámara del controlador.

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Constantes

Comentarios

El DDI del evento de cámara se define mediante KSEVENTSETID_CameraEvent, un conjunto de eventos de streaming de kernel que puede usar la canalización para habilitar o deshabilitar las notificaciones de eventos de cámara del controlador. Se trata de un evento de nivel de filtro que significa que el controlador debe implementar y definir el evento en la tabla de automatización del filtro y usar KsFilterGenerateEvents (o KsGenerateEvents con objeto de filtro) para generar notificaciones de eventos.

KSEVENTSETID_CameraEvent y sus estructuras de datos relacionadas se definen en Ksmedia.h como se indica a continuación.

#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)

Actualmente solo se define KSEVENT_PHOTO_SAMPLE_SCANNED evento para KSEVENTSETID_CameraEvent conjunto de eventos. La canalización se suscribe y escucha las notificaciones de eventos de KSEVENT_PHOTO_SAMPLE_SCANNED para sincronizar la reproducción de sonido del obturador para una captura de fotos. La canalización solo responderá a la primera notificación de eventos de KSEVENT_PHOTO_SAMPLE_SCANNED para una captura de fotos o una secuencia de fotos determinada. Reproducirá el sonido del obturador solo una vez para cualquier captura de fotos o captura de secuencia de fotos y omitirá las notificaciones posteriores hasta que se complete o detenga la captura de la foto o secuencia de fotos.

Este conjunto de eventos es opcional. Si el controlador no implementa el conjunto de eventos, la canalización cerrará de forma predeterminada la reproducción de sonido cuando DevProxy reciba la primera muestra de foto en una captura de fotos.

Si el controlador implementa este conjunto de eventos, la canalización solo responderá al evento y no generará un sonido obturador cuando reciba una muestra de foto. Por lo tanto, es importante asegurarse de que el controlador genera una notificación de eventos KSEVENT_PHOTO_SAMPLE_SCANNED cuando se examina la muestra de fotos, si el controlador implementa la compatibilidad de este conjunto de eventos.

Requisitos