KSPROPERTY_CAMERACONTROL_EXTENDED_FLASHMODE (normale e sequenza)
Il controllo proprietà flash imposta l'operazione in modalità flash per la modalità foto normale e sequenza della fotocamera.
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 .
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à flash seguenti supportate dal driver.
| Modalità flash | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_OFF | Flash è spento. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON | Flash è attivato a livello di intensità predefinito. |
| KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER | Flash è acceso a un livello di potenza specifico. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO | Flash è automatico in base alle condizioni di illuminazione. |
| KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER | Flash è automatico in base alle condizioni di illuminazione a un livello di alimentazione specifico. |
I flag di funzionalità seguenti possono essere combinati con le impostazioni flash precedenti ad eccezione di KSCAMERA_EXTENDEDPROP_FLASH_OFF.
| Funzionalità Flash | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_FLASH_REDEYEREDUCTION | Abilitare la funzionalità di riduzione del rollforward. Questo flag può essere combinato con qualsiasi altra impostazione. |
| KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH | Impostare il flash per un solo trigger. Questa funzionalità viene ignorata quando la fotocamera non è in modalità sequenza di foto. |
| KSCAMERA_EXTENDEDPROP_FLASH_MULTIFLASHSUPPORTED | Impostare flash per attivare ogni fotogramma di sequenza. Questa funzionalità viene ignorata quando la fotocamera non è in modalità sequenza di foto. |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene la modalità flash attualmente impostata per la fotocamera.
La modalità flash predefinita per una fotocamera è KSCAMERA_EXTENDEDPROP_FLASH_OFF. Se la fotocamera supporta flash, KSCAMERA_EXTENDEDPROP_FLASH_OFF, KSCAMERA_EXTENDEDPROP_FLASH_ON e KSCAMERA_EXTENDEDPROP_FLASH_AUTO sono modalità necessarie. Le modalità KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER e KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER sono facoltative.
Se la modalità sequenza di foto è supportata dalla fotocamera, la proprietà del controllo flash è necessaria con il supporto per KSCAMERA_EXTENDEDPROP_FLASH_SINGLEFLASH.
Questo controllo proprietà è sincrono 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à | Valori della modalità Flash supportati |
| Flags | (Impostazione del valore della modalità flash corrente) | (flag di funzionalità flash) |
Quando la modalità torcia è KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER o KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER, il membro Value.ull di KSCAMERA_EXTENDEDPROP_VALUE contiene un valore di livello di intensità compreso tra 0 e 100. Un'intensità pari a 0 indica un livello minimo e un'intensità di 100 indica un livello di intensità massima. Quando i flag di alimentazione regolabili non sono impostati, il valore per l'impostazione di intensità normalizzata viene restituito in Value.ull.
Se in precedenza non è stata impostata alcuna modalità flash, Flags viene impostato su KSCAMERA_EXTENDEDPROP_FLASH_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 Flags è KSCAMERA_EXTENDEDPROP_FLASH_ON_ADJUSTABLEPOWER o KSCAMERA_EXTENDEDPROP_FLASH_AUTO_ADJUSTABLEPOWER.
Requisiti
Versione: Disponibile a partire da Windows 8.1
Intestazione: Ksmedia.h (include Ksmedia.h)