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.

Syntaxe

typedef enum {
  KSEVENT_PHOTO_SAMPLE_SCANNED
} KSEVENT_CAMERAEVENT;

Constantes

 
KSEVENT_PHOTO_SAMPLE_SCANNED
Notifications d’événements pour synchroniser la lecture sonore de l’obturateur pour une capture photo.

Remarques

L’événement d’appareil photo 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 de niveau filtre, ce qui signifie que le pilote doit implémenter et définir l’événement dans la table d’automatisation du filtre et utiliser KsFilterGenerateEvents (ou KsGenerateEvents avec l’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 sonore de l’obturateur pour une capture de photos. Le pipeline répond uniquement à la première notification d’événement KSEVENT_PHOTO_SAMPLE_SCANNED pour une capture photo ou une séquence de photos donnée. Il ne lirea le son de l’obturateur qu’une seule fois pour une capture de photo ou une capture de séquence de photos et ignorera les notifications suivantes jusqu’à ce que la capture de photo ou de séquence de photos 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 effectue par défaut la lecture du son d’obturation lorsque le premier échantillon 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 cet ensemble d’événements.

Exigences

Exigence Valeur
d’en-tête ksmedia.h