KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (modalità definita dal driver)
La proprietà modalità scena seleziona una modalità definita dal driver che rappresenta una raccolta di controlli predefiniti. Il driver determina i set di impostazioni assegnati a una modalità scena e abilita tali impostazioni di controllo quando viene selezionata una scena.
Tabella di riepilogo dell'utilizzo
| Get | Set | Destinazione | Tipo di descrittore di proprietà | Tipo valore proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtra | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VALUE . Il KSCAMERA_EXTENDEDPROP_VALUE è obbligatorio, ma il membro Value viene ignorato.
Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato su questa dimensione totale dei dati della proprietà.
Il membro Capability di KSCAMERA_EXTENDEDPROP_HEADER contiene una combinazione OR bit per bit di una o più delle modalità della scena seguenti supportate dal driver.
| Modalità scena | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO | Modalità profumo automatica. I controlli si trovano nelle impostazioni auto. |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO | Modalità scena macro (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT | Modalità scena verticale (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT | Modalità scena sportiva (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW | Modalità scena neve (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT | Modalità scena notturna (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH | Modalità scena spiaggia (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET | Modalità scena tramonto (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT | Modalità scena candela (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE | Modalità scena orizzontale (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT | Modalità scena verticale notturna (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT | Modalità scena backlit (driver definito). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL | I controlli vengono modificati manualmente e non vengono impostate modalità di scena predefinite. |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene la modalità scena attualmente impostata per la fotocamera. La modalità scena predefinita per una fotocamera è sempre KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.
Questo controllo proprietà è asincrono e non annullabile.
Commenti
Recupero della proprietà
Quando risponde a una richiesta di KSPROPERTY_TYPE_GET, il driver imposta i membri del KSCAMERA_EXTENDEDPROP_HEADER su quanto segue.
| Membro | Valore |
|---|---|
| Versione | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Dimensione | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Risultato | 0 |
| Funzionalità | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (valori della modalità scena supportati) |
| Flags | Impostazione del valore della modalità scena corrente (un solo valore) |
Se in precedenza non è stata impostata alcuna modalità scena, Flags viene impostato su KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (impostazione predefinita).
Impostazione della proprietà
Quando la proprietà è impostata, una richiesta di KSPROPERTY_TYPE_SET, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER conterrà la modalità scena da abilitare.
Requisiti
Versione: Disponibile a partire da Windows 8.1
Intestazione: Ksmedia.h (include Ksmedia.h)