KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE
La modalità torcia determina come viene usato il flash di una fotocamera in condizioni di bassa luce. Una fonte di luce di intensità inferiore è continuamente fornita dal flash per consentire una luce sufficiente per operazioni come lo stato attivo automatico.
Tabella riepilogo utilizzo
| Get | Set | Destinazione | Tipo di descrittore delle proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
Sì |
Sì |
Filtra |
Il valore della proprietà (dati operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VALUE .
Le dimensioni totali dei dati delle proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato su questa dimensione totale dei dati delle proprietà.
Il membro Capability di KSCAMERA_EXTENDEDPROP_HEADER contiene una combinazione OR bit per bit di una o più delle modalità di torcia seguenti supportate dal driver.
| Modalità torcia | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF | Torchlight è disattivato. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON | Torchlight è attivo a livello di intensità predefinita. |
| KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER | Torchlight è attivo a un livello di potenza specifico. |
Il membro Flag di KSCAMERA_EXTENDEDPROP_HEADER contiene la modalità torcia attualmente impostata per la fotocamera. La modalità torcia predefinita per una fotocamera è KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF e il driver deve supportare questa modalità torcia.
Questo controllo proprietà è sincrono e non annullabile.
Commenti
Recupero della proprietà
Quando si risponde a una richiesta di KSPROPERTY_TYPE_GET, il driver imposta i membri del KSCAMERA_EXTENDEDPROP_HEADER al seguente.
| Membro | Valore |
|---|---|
| Versione | 1 |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF). |
| Dimensione | sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE) |
| Risultato | 0 |
| Funzionalità | Valori della modalità torch supportati. |
| Flags | Impostazione del valore della modalità torcia corrente (solo un valore). |
Quando la modalità torcia è KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER, il membro Value.ull di KSCAMERA_EXTENDEDPROP_VALUE contiene un valore di livello di intensità compreso tra 0 - 100. Un'intensità di 0 indica un livello minimo e un'intensità di 100 indica un livello massimo di intensità.
Se non è stata impostata alcuna modalità scena in precedenza, Flags è impostato su KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (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à torcia da impostare. Il membro Value.ull di KSCAMERA_EXTENDEDPROP_VALUE conterrà il livello di intensità da impostare se Flag è KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER.
Requisiti
Versione |
Disponibile a partire da Windows 8.1. |
Intestazione |
Ksmedia.h (includere Ksmedia.h) |