enumeração KSEVENT_CAMERAEVENT (ksmedia.h)

KSEVENT_CAMERAEVENT enumera um conjunto de eventos de streaming de kernel que pode ser usado pelo pipeline para habilitar ou desabilitar notificações de eventos de câmera do driver.

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Constantes

Comentários

A DDI do evento de câmera é definida por KSEVENTSETID_CameraEvent, um conjunto de eventos de streaming de kernel que pode ser usado pelo pipeline para habilitar ou desabilitar as notificações de eventos da câmera do driver. Esse é um evento de nível de filtro que significa que o driver deve implementar e definir o evento na tabela de automação do filtro e usar KsFilterGenerateEvents (ou KsGenerateEvents com objeto de filtro) para gerar notificações de evento.

KSEVENTSETID_CameraEvent e suas estruturas de dados relacionadas são definidas em Ksmedia.h da seguinte maneira.

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

Atualmente, apenas KSEVENT_PHOTO_SAMPLE_SCANNED evento é definido para KSEVENTSETID_CameraEvent conjunto de eventos. O pipeline assina e escuta as notificações de evento KSEVENT_PHOTO_SAMPLE_SCANNED para sincronizar a reprodução de som do obturador para uma captura de fotos. O pipeline responderá apenas à primeira notificação de evento KSEVENT_PHOTO_SAMPLE_SCANNED para uma determinada captura de foto ou sequência de fotos. Ele reproduzirá o som do obturador apenas uma vez para qualquer captura de foto única ou captura de sequência de fotos e ignorará as notificações subsequentes até que a captura de sequência de fotos ou fotos seja concluída ou interrompida.

Esse conjunto de eventos é opcional. Se o driver não implementar o conjunto de eventos, o pipeline usará como padrão a reprodução de som do obturador quando o primeiro exemplo de foto em uma captura de foto for recebido pelo DevProxy.

Se o driver implementar esse conjunto de eventos, o pipeline responderá apenas ao evento e não gerará um som de obturador quando receber uma amostra de foto. Portanto, é importante garantir que uma notificação de evento KSEVENT_PHOTO_SAMPLE_SCANNED seja gerada pelo driver quando o exemplo de foto for verificado, se o driver implementar o suporte desse conjunto de eventos.

Requisitos