KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (mode défini par le pilote)
La propriété mode scène sélectionne un mode défini par le pilote qui représente une collection de contrôles prédéfinis. Le pilote détermine les présélections affectées à un mode scène et active ces paramètres de contrôle lorsqu’une scène est sélectionnée.
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 . Le KSCAMERA_EXTENDEDPROP_VALUE est obligatoire, mais le membre Value est ignoré.
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 scène suivants pris en charge par le pilote.
| Mode scène | Description |
|---|---|
| KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO | Mode parfum automatique. Les contrôles sont à leurs paramètres automatiques. |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO | Mode de scène macro (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT | Mode scène portrait (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT | Mode scène sport (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW | Mode de scène de neige (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT | Mode de scène de nuit (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH | Mode scène de plage (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET | Mode de scène de coucher du soleil (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT | Mode de scène candlelight (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE | Mode de scène paysage (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT | Mode de scène portrait nocturne (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT | Mode de scène rétro-éclairé (défini par le pilote). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL | Les contrôles sont modifiés manuellement et aucun mode de scène prédéfini n’est défini. |
Le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode scène actuellement défini pour la caméra. Le mode scène par défaut d’une caméra est toujours KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.
Ce contrôle de propriété est asynchrone 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é | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (valeurs du mode scène prises en charge) |
| Indicateurs | Paramètre de valeur du mode scène actuel (une seule valeur) |
Si aucun mode de scène n’a été défini précédemment, Indicateurs est défini sur KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (valeur par défaut).
Définition de la propriété
Lorsque la propriété est définie, une requête KSPROPERTY_TYPE_SET, le membre Flags de KSCAMERA_EXTENDEDPROP_HEADER contient le mode de scène à activer.
Configuration requise
Version: Disponible à partir de Windows 8.1
En-tête: Ksmedia.h (inclure Ksmedia.h)