KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
Le mode torche détermine comment le flash d’un appareil photo est utilisé dans des conditions de faible luminosité. Une source de lumière de faible intensité est continuellement fournie par le flash pour permettre une lumière suffisante pour les opérations telles que le focus automatique.
Tableau récapitulatif de l’utilisation
| Get | Set | Cible | Type de descripteur de propriété | Type de valeur de propriété |
|---|---|---|---|---|
Oui |
Oui |
Filtrer |
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 de bits OU d’un ou plusieurs des modes de torche suivants pris en charge par le pilote.
| Mode Torch | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | Torchlight est éteint. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | Torchlight est activé au niveau d’intensité par défaut. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | Torchlight est allumé à un niveau de puissance spécifique. |
Le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode torche actuellement défini pour l’appareil photo. Le mode torche par défaut d’une caméra est KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF et le pilote doit prendre en charge ce mode torche.
Ce contrôle de propriété est synchrone et n’est pas annulable.
Remarques
Obtention de la propriété
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 | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Taille | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Résultats | 0 |
| Fonctionnalité | Valeurs du mode torche prises en charge. |
| Indicateurs | Paramètre de valeur du mode torche actuel (une seule valeur). |
Lorsque le mode torche est KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER, le membre Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contient une valeur de niveau d’intensité comprise entre 0 et 100. Une intensité de 0 indique un niveau minimal et une intensité de 100 indique un niveau d’intensité maximal.
Si aucun mode de scène n’a été défini précédemment, Indicateurs est défini sur KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (valeur par défaut).
Définition de la propriété
Lorsque la propriété est définie, une demande de KSPROPERTY_TYPE_SET, le membre Indicateurs de KSCAMERA_EXTENDEDPROP_HEADER contient le mode torche à définir. Le membre Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contient le niveau d’intensité à définir si Indicateurs est KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER.
Spécifications
Version |
Disponible à partir de Windows 8.1. |
En-tête |
Ksmedia.h (inclure Ksmedia.h) |