Partager via

KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (sous-modèle)

  • Article

La propriété KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE permet de configurer un sous-modèle.

Récapitulatif de l’utilisation

Les sous-modèles suivants sont définis comme suit.

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE est utilisé par une séquence de photos régulière.

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE est utilisé pour indiquer qu’une séquence de photos est variable. Si des paramètres par image sont spécifiés, l’indicateur de KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE est spécifié dans le champ de sous-modèle de la structure KSCAMERA_EXTENDEDPROP_PHOTOMODE pour indiquer une séquence de photos variables, même si aucun paramètre d’élément n’est spécifié (le nombre d’éléments est de 0 pour tous les cadres). Lorsque le nombre d’images est de 1 et que le nombre d’éléments est 0, la séquence de photos variable est réduite à une séquence de photos variables de cadre à l’aide de paramètres globaux.

Voici une définition de la structure KSCAMERA_EXTENDEDPROP_PHOTOMODE définie dans ksmedia.h :

typedef struct tagKSCAMERA_EXTENDEDPROP_PHOTOMODE {  
    ULONG       RequestedHistoryFrames;  
    ULONG       MaxHistoryFrames;  
    ULONG       SubMode;  
    ULONG       Reserved;  
} KSCAMERA_EXTENDEDPROP_PHOTOMODE, *PKSCAMERA_EXTENDEDPROP_PHOTOMODE;

Le mode de séquence de photos variables présente les caractéristiques uniques suivantes sur une séquence de photos.

  • Utilisez toujours une séquence de photos finie.

  • Les paramètres par image sont appliqués lorsque le nombre d’images est supérieur à 0.

  • Le pilote arrête automatiquement la séquence de photos à la fin sans avoir à déclencher le KS_VideoControlFlag_StopPhotoSequenceCapture lorsqu’un nombre de boucles supérieur à 0 est spécifié.

  • Le dernier échantillon doit être marqué avec l’indicateur KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE.

  • Le pipeline de capture ne supprime aucun échantillon du pilote.

  • Ni le pipeline ni le driver\MFT0 ne génèrent de miniature de photo.

Cette propriété est asynchrone et n’est pas annulable.

Configuration requise

En-tête: Ksmedia.h (inclure Ksmedia.h)