KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (normal et séquence)
Le contrôle de propriété flash définit l’opération de mode flash pour le mode photo normal et le mode photo séquence de l’appareil photo.
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 de bits OU d’un ou plusieurs des modes flash suivants pris en charge par le pilote.
| Mode Flash | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | Flash est désactivé. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | Flash est activé au niveau d’intensité par défaut. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | Flash est activé à un niveau d’alimentation spécifique. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | Le flash est automatique en fonction des conditions d’éclairage. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | Le flash est automatique en fonction des conditions d’éclairage à un niveau de puissance spécifique. |
Les indicateurs de fonctionnalité suivants peuvent être combinés avec les paramètres flash précédents, à l’exception de KSCAMERA_EXTENDEDPROP_FLASH_OFF.
| Fonctionnalité Flash | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | Activez la fonctionnalité de réduction redeye. Cet indicateur peut être combiné à n’importe quel autre paramètre. |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | Définissez le flash pour un seul déclencheur. Cette fonctionnalité est ignorée lorsque l’appareil photo n’est pas en mode séquence photo. |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | Définissez le flash pour qu’il se déclenche sur chaque image de séquence. Cette fonctionnalité est ignorée lorsque l’appareil photo n’est pas en mode séquence photo. |
Le membre Indicateurs de KSCAMERA_EXTENDEDPROP_HEADER contient le mode flash actuellement défini pour l’appareil photo.
Le mode flash par défaut pour un appareil photo est KSCAMERA_EXTENDEDPROP_FLASH_OFF. Si l’appareil photo prend en charge le flash, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON et KSCAMERA_EXTENDEDPROP_FLASH_AUTO sont des modes obligatoires. Les modes KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER et KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER sont facultatifs.
Si le mode séquence photo est pris en charge par l’appareil photo, la propriété de contrôle flash est requise avec prise en charge des KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH.
Ce contrôle de propriété est synchrone et non annulable.
Remarques
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 en mode Flash prises en charge |
| Indicateurs | (Paramètre de valeur du mode flash actuel) | (indicateurs de fonctionnalité flash) |
Lorsque le mode torche est KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER ou KSCAMERA_EXTENDEDPROP_FLASH_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. Lorsque les indicateurs d’alimentation réglables ne sont pas définis, la valeur du paramètre d’intensité normalisée est retournée dans Valeur.ull.
Si aucun mode flash n’a été défini précédemment, flags est défini sur KSCAMERA_EXTENDEDPROP_FLASH_OFF (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 torche à définir. Le membre Value.ull de KSCAMERA_EXTENDEDPROP_VALUE contient le niveau d’intensité à définir si les indicateurs sont KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER ou KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER.
Configuration requise
Version: Disponible à partir de Windows 8.1
En-tête: Ksmedia.h (inclure Ksmedia.h)