Partager via


KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMAXFRAMERATE

Cette propriété fournit la fréquence d’images de capture maximale pour un appareil photo lorsqu’il est en mode séquence photo.

Tableau récapitulatif de l’utilisation

Get Set Cible Type de descripteur de propriété Type de valeur de propriété

Oui

Oui

Épingle

KSPROPERTY

KSCAMERA_EXTENDEDPROP_HEADER

La valeur de propriété (données d’opération) contient une structure KSCAMERA_EXTENDEDPROP_HEADER et une structure KSCAMERA_EXTENDEDPROP_VALUE . La fréquence d’images maximale en images par seconde est définie ou retournée en tant que valeur dans KSCAMERA_EXTENDEDPROP_VALUE.

Aucun indicateur n’est défini dans le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER pour cette propriété.

La taille totale des données de propriété est sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Le membre Size de KSCAMERA_EXTENDEDPROP_HEADER est défini sur cette taille totale des données de propriété.

Ce contrôle de propriété est asynchrone et n’est pas annulable.

Remarques

Lors de la réponse à une demande de KSPROPERTY_TYPE_GET, le pilote définit les membres du KSCAMERA_EXTENDEDPROP_HEADER comme suit.

Membre Valeur
Version 1
PinId ID d’épingle de l’épingle de la photo.
Taille

sizeof(KSCAMERA_EXTENDEDPROP_HEADER) +

sizeof(KSCAMERA_EXTENDEDPROP_VALUE)

Résultats

Valeur d’erreur résultant de la tentative de lecture de la fréquence d’images maximale.

Sinon, il prend la valeur 0.

Fonctionnalité KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL
Indicateurs 0

La valeur de fréquence d’images est définie dans le membre Ratio de KSCAMERA_EXTENDEDPROP_VALUE. Ratio.HighPart contient le numérateur de la fréquence d’images et Ratio.LowPart contient le dénominateur de la fréquence d’images.

Lorsque le pilote est en mode séquence de photos, il peut être nécessaire de limiter la fréquence d’images maximale de la capture photo. Cela permet de s’assurer que les scénarios de capture « moment dans le temps », avec un certain nombre d’images d’historique, sont contenus dans un intervalle de temps configuré. Par exemple, en fonction des contraintes de mémoire, si l’application souhaite capturer 1 seconde de l’historique passé, il est nécessaire de limiter le taux de capture afin que seul N nombre d’images soit nécessaire.

Lorsqu’il est défini, le pilote doit utiliser la fréquence d’images fournie, même si la caméra peut capturer des images rapidement que la vitesse demandée. Si nécessaire, le pilote peut supprimer des trames supplémentaires pour prendre en charge le taux demandé.

La définition de la valeur de fréquence d’images maximale sur 0 (0 pour highpart et 0 pour la partie faible du ratio) efface le paramètre de fréquence d’images maximale dans le pilote et a le même effet que de demander au pilote de fournir des images aussi rapidement que possible. Une fois que la fréquence d’images est définie sur 0, toute requête suivante retourne la valeur de la fréquence d’images maximale possible pour le pilote de caméra.

Spécifications

Version

Disponible à partir de Windows 8.1.

En-tête

Ksmedia.h (inclure Ksmedia.h)