Share via


enumerazione KSEVENT_CAMERAEVENT (ksmedia.h)

KSEVENT_CAMERAEVENT enumera un set di eventi di streaming del kernel che può essere usato dalla pipeline per abilitare o disabilitare le notifiche degli eventi della fotocamera dal driver.

Sintassi

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Costanti

 
KSEVENT_PHOTO_SAMPLE_SCANNED
Notifiche degli eventi per sincronizzare la riproduzione audio dell'otturatore per un'acquisizione di foto.

Commenti

L'evento della fotocamera DDI è definito da KSEVENTSETID_CameraEvent, un set di eventi di streaming del kernel che può essere usato dalla pipeline per abilitare o disabilitare le notifiche degli eventi della fotocamera dal driver. Si tratta di un evento a livello di filtro che indica che il driver deve implementare e definire l'evento nella tabella di automazione del filtro e usare KsFilterGenerateEvents (o KsGenerateEvents con oggetto filtro) per generare notifiche degli eventi.

KSEVENTSETID_CameraEvent e le relative strutture di dati sono definite in Ksmedia.h come indicato di seguito.

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

Attualmente è definito solo KSEVENT_PHOTO_SAMPLE_SCANNED evento per KSEVENTSETID_CameraEvent set di eventi. La pipeline sottoscrive e ascolta le notifiche degli eventi KSEVENT_PHOTO_SAMPLE_SCANNED per sincronizzare la riproduzione audio dell'otturatore per un'acquisizione di foto. La pipeline risponderà solo alla prima notifica degli eventi KSEVENT_PHOTO_SAMPLE_SCANNED per una determinata acquisizione di foto o sequenza di foto. Riproduce il suono dell'otturatore una sola volta per ogni singola acquisizione di foto o sequenza di foto e ignora le notifiche successive fino a quando la foto o l'acquisizione della sequenza di foto non viene completata o arrestata.

Questo set di eventi è facoltativo. Se il driver non implementa il set di eventi, per impostazione predefinita la pipeline eseguirà la riproduzione del suono dell'otturatore quando il primo campione di foto in un'acquisizione di foto viene ricevuto da DevProxy.

Se il driver implementa questo set di eventi, la pipeline risponderà solo all'evento e non genererà un suono di otturatore quando riceve un campione di foto. È quindi importante assicurarsi che venga generata una notifica degli eventi KSEVENT_PHOTO_SAMPLE_SCANNED dal driver quando viene analizzato l'esempio di foto, se il driver implementa il supporto di questo set di eventi.

Requisiti

Requisito Valore
Intestazione ksmedia.h