KSEVENT_CAMERAEVENT-Enumeration (ksmedia.h)

KSEVENT_CAMERAEVENT listet einen Kernelstreamingereignissatz auf, der von der Pipeline verwendet werden kann, um Kameraereignisbenachrichtigungen vom Treiber zu aktivieren oder zu deaktivieren.

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Konstanten

KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigungen zum Synchronisieren der Auslösesoundwiedergabe für eine Fotoaufnahme.

Hinweise

Das Kameraereignis-DDI wird durch KSEVENTSETID_CameraEvent definiert, einem Kernelstreamingereignissatz, der von der Pipeline verwendet werden kann, um Kameraereignisbenachrichtigungen vom Treiber zu aktivieren oder zu deaktivieren. Dies ist ein Ereignis auf Filterebene, was bedeutet, dass der Treiber das Ereignis in der Automatisierungstabelle des Filters implementieren und definieren und KsFilterGenerateEvents (oder KsGenerateEvents mit Filterobjekt) verwenden muss, um Ereignisbenachrichtigungen zu generieren.

KSEVENTSETID_CameraEvent und die zugehörigen Datenstrukturen werden in Ksmedia.h wie folgt definiert.

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

Derzeit ist nur KSEVENT_PHOTO_SAMPLE_SCANNED Ereignis für KSEVENTSETID_CameraEvent Ereignissatz definiert. Die Pipeline abonniert und lauscht die KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigungen, um die Wiedergabe des Auslösesounds für eine Fotoaufnahme zu synchronisieren. Die Pipeline reagiert nur auf die erste KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigung für eine bestimmte Fotoaufnahme oder Fotosequenz. Es gibt den Auslöserton nur einmal für eine einzelne Fotoaufnahme oder Fotosequenzaufnahme ab und ignoriert nachfolgende Benachrichtigungen, bis die Foto- oder Fotosequenzaufnahme abgeschlossen oder beendet ist.

Dieser Ereignissatz ist optional. Wenn der Treiber den Ereignissatz nicht implementiert, schließt die Pipeline standardmäßig die Soundwiedergabe, wenn das erste Fotobeispiel in einer Fotoaufnahme von DevProxy empfangen wird.

Wenn der Treiber diesen Ereignissatz implementiert, reagiert die Pipeline nur auf das Ereignis und erzeugt keinen Auslöserton, wenn sie ein Fotobeispiel empfängt. Daher ist es wichtig, sicherzustellen, dass eine KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigung vom Treiber generiert wird, wenn das Fotobeispiel gescannt wird, wenn der Treiber die Unterstützung dieses Ereignissatzes implementiert.

Anforderungen

Anforderung	Wert
Header	ksmedia.h