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)

Voir aussi

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE