Freigeben über

KSEVENT_CAMERAEVENT-Aufzählung (ksmedia.h)

  • Artikel

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 Verschlusssoundwiedergabe für eine Fotoaufnahme.

Bemerkungen

Das Kameraereignis DDI wird durch KSEVENTSETID_CameraEventdefiniert, ein Kernelstreaming-Ereignissatz, der von der Pipeline verwendet werden kann, um Kameraereignisbenachrichtigungen vom Treiber zu aktivieren oder zu deaktivieren. Dies ist ein Ereignis auf Filterebene, das bedeutet, dass der Treiber das Ereignis in der Automatisierungstabelle des Filters implementieren und definieren muss und KsFilterGenerateEvents (oder KsGenerateEvents mit Filterobjekt) zum Generieren von Ereignisbenachrichtigungen verwendet.

KSEVENTSETID_CameraEvent und die zugehörigen Datenstrukturen werden wie folgt in Ksmedia.h 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 hört sich die KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigungen an, um die Verschlusssoundwiedergabe für eine Fotoaufnahme zu synchronisieren. Die Pipeline antwortet nur auf die erste KSEVENT_PHOTO_SAMPLE_SCANNED Ereignisbenachrichtigung für eine bestimmte Fotoaufnahme oder Fotosequenz. Er gibt den Verschlusssound nur einmal für eine einzelne Fotoaufnahme oder Fotosequenzaufnahme wieder und ignoriert nachfolgende Benachrichtigungen, bis die Foto- oder Fotosequenzaufnahme abgeschlossen oder beendet ist.

Dieser Ereignissatz ist optional. Wenn der Treiber den Ereignissatz nicht implementiert, wird die Audiowiedergabe standardmäßig durch die Pipeline ausgelöst, 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 generiert keinen Verschlusssound, wenn es 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