KSPROPERTY_CAMERACONTROL_EXTENDED_OPTIMIZATIONHINT (stratégie de performances des applications)
Les pilotes de caméra peuvent optimiser leur opération de capture en fonction des indicateurs fournis par l’application. Cette propriété indique au pilote de définir sa stratégie de performances en fonction de l’opération qui est probablement la plus utilisée. Par exemple, lorsqu’il est optimisé pour la photo, le pilote de l’appareil photo peut programmer le capteur pour optimiser la vitesse d’exposition et la résolution du capteur afin de réduire la latence du déclencheur de capture photo à la capture d’image. De même, lorsqu’il est optimisé pour la vidéo, le pilote de caméra peut programmer le capteur pour une fréquence d’images plus élevée, mais à une résolution inférieure.
Tableau récapitulatif de l’utilisation
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
| Oui | Oui | Filtrer | 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 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é.
Le membre Capability de KSCAMERA_EXTENDEDPROP_HEADER contient une combinaison OR au niveau du bit d’un ou plusieurs des indicateurs d’optimisation suivants.
| indicateur d'optimisation | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO | Le fonctionnement de l’appareil photo est optimisé pour les photos |
| KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO | Le fonctionnement de la caméra est optimisé pour la vidéo |
Le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient l’optimisation actuellement définie pour la caméra (une valeur).
Le type d’optimisation par défaut est KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO. Si cette propriété est prise en charge par le pilote de caméra, les deux types d’optimisation doivent être pris en charge.
Ce contrôle de propriété est synchrone et non annulable.
Remarques
Modes d’optimisation
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO
Tous les pilotes de caméra doivent être dans ce mode jusqu’à ce qu’ils soient explicitement informés d’utiliser le mode KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO. L’objectif de ce mode est d’optimiser le matériel de l’appareil photo pour les opérations photo. Les opérations vidéo doivent toujours être fonctionnelles dans ce mode.
KSCAMERA_EXTENDEDPROP_OPTIMIZATION_VIDEO
Ce mode indique que la caméra sera probablement utilisée pour les opérations vidéo. Le pilote de caméra doit optimiser le matériel pour les opérations vidéo pour ce mode. Les opérations photo doivent être fonctionnelles, mais la priorité d’utilisation des ressources est pour les opérations vidéo.
Obtention de la propriété
Lorsque vous répondez à une demande de KSPROPERTY_TYPE_GET, le pilote définit les membres du KSCAMERA_EXTENDEDPROP_HEADER comme suit.
| Membre | Valeur |
|---|---|
| Version | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Taille | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Résultats | 0 |
| Fonctionnalité | Valeurs d’optimisation prises en charge |
| Indicateurs | Paramètre de valeur d’optimisation actuel |
Si aucun mode d’optimisation n’a été défini précédemment, le pilote définit indicateurs sur KSCAMERA_EXTENDEDPROP_OPTIMIZATION_PHOTO (par défaut).
Définition de la propriété
Lorsque la propriété est définie, une demande de KSPROPERTY_TYPE_SET, le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode d’optimisation à définir.
Configuration requise
Version: Disponible à partir de Windows 8.1
En-tête: Ksmedia.h (inclure Ksmedia.h)