Partager via

énumération KSEVENT_CAMERAEVENT (ksmedia.h)

  • Article

KSEVENT_CAMERAEVENT énumère un jeu d’événements de streaming de noyau qui peut être utilisé par le pipeline pour activer ou désactiver les notifications d’événements de caméra à partir du pilote.

Syntax

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Constantes

 
KSEVENT_PHOTO_SAMPLE_SCANNED
Notifications d’événements pour synchroniser la lecture du son d’obturation pour une capture photo.

Remarques

L’événement de caméra DDI est défini par KSEVENTSETID_CameraEvent, un jeu d’événements de diffusion en continu du noyau qui peut être utilisé par le pipeline pour activer ou désactiver les notifications d’événements de caméra à partir du pilote. Il s’agit d’un événement au niveau du filtre, ce qui signifie que le pilote doit implémenter et définir l’événement dans la table Automation du filtre et utiliser KsFilterGenerateEvents (ou KsGenerateEvents avec objet de filtre) pour générer des notifications d’événements.

KSEVENTSETID_CameraEvent et ses structures de données associées sont définies dans Ksmedia.h comme suit.

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

Actuellement, seul KSEVENT_PHOTO_SAMPLE_SCANNED événement est défini pour KSEVENTSETID_CameraEvent jeu d’événements . Le pipeline s’abonne et écoute les notifications d’événements KSEVENT_PHOTO_SAMPLE_SCANNED pour synchroniser la lecture du son d’obturateur pour une capture photo. Le pipeline répond uniquement à la première notification d’événement KSEVENT_PHOTO_SAMPLE_SCANNED pour une capture photo ou une séquence photo donnée. Il ne lit le son de l’obturateur qu’une seule fois pour toute capture de photo ou capture de séquence de photos et ignore les notifications suivantes jusqu’à ce que la capture de photo ou de séquence photo soit terminée ou arrêtée.

Cet ensemble d’événements est facultatif. Si le pilote n’implémente pas le jeu d’événements, le pipeline est par défaut la lecture du son d’obturation lorsque le premier échantillon de photo d’une capture photo est reçu par DevProxy.

Si le pilote implémente ce jeu d’événements, le pipeline répond uniquement à l’événement et ne génère pas de son d’obturateur lorsqu’il reçoit un exemple de photo. Par conséquent, il est important de s’assurer qu’une notification d’événement KSEVENT_PHOTO_SAMPLE_SCANNED est générée par le pilote lorsque l’exemple de photo est analysé, si le pilote implémente la prise en charge de ce jeu d’événements.

Configuration requise

Condition requise Valeur
En-tête ksmedia.h