KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
La proprietà modalità di bilanciamento del bianco specifica se viene utilizzata l'elaborazione automatica per il bilanciamento del bianco o un valore di temperatura manuale.
Tabella riepilogativa utilizzo
| Recupero | Set | Destinazione | Tipo descrittore di proprietà | Tipo di valore della proprietà |
|---|---|---|---|---|
| Sì | Sì | Filtro | KSPROPERTY | KSCAMERA_EXTENDEDPROP_HEADER |
Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING.
Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING). Il membro Size di KSCAMERA_EXTENDEDPROP_HEADER è impostato sulle dimensioni totali dei dati delle proprietà.
Il membro Capability di KSCAMERA_EXTENDEDPROP_HEADER contiene una combinazione OR bit per bit di una o più delle opzioni di elaborazione video seguenti.
| Modalità di elaborazione | Descrizione |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Fotocamera driver usa la propria logica di elaborazione per il video. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Fotocamera driver usa un metodo di elaborazione preimpostato o un metodo basato sulla temperatura. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | Il metodo di elaborazione video corrente è bloccato. |
Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene il flag di elaborazione video attualmente impostato per la fotocamera. L'impostazione KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO può essere combinata con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.
Questo controllo proprietà è asincrono e non annullabile.
Osservazioni:
Modalità di elaborazione
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Ciò indica che l'elaborazione automatica è supportata. Il driver userà la logica interna per ottimizzare l'elaborazione video. Per una richiesta di KSPROPERTY_TYPE_GET, il membro VideoProc di KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING deve contenere il valore determinato del driver corrente per l'elaborazione video. Nel caso di White Balance, deve contenere la temperatura corrente in Kelvin. Il membro Mode viene ignorato per l'operazione automatica.
Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK come valore OR bit per bit. Se bloccato, il comportamento previsto del driver della fotocamera consiste nel convergere sul bilanciamento del bianco e bloccare il valore di bilanciamento del bianco sul valore convergente, non tentando di bilanciare automaticamente il bianco, fino a quando non viene ricevuto un nuovo comando di bilanciamento del bianco.
Bloccando, senza combinare la modalità automatica, un controllo già bloccato deve essere considerato come no-op dal driver della fotocamera. Il blocco, in combinazione con la modalità automatica, un controllo già bloccato dovrebbe attivare una nuova convergenza.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manual indica che per l'elaborazione video vengono forniti i valori specifici. Nel caso del bilanciamento del bianco, se il membro Mode di KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING indica KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE, VideoProc.Value.ul conterrà il valore della temperatura in gradi Kelvin.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK Il flag di opzione di blocco indica che l'elaborazione video corrente è bloccata a qualsiasi valore attualmente programmato. Ad esempio, un'applicazione può richiedere la modalità automatica fino a quando non viene determinato un bilanciamento del bianco specifico, a quel punto l'applicazione deciderà di scattare una sequenza di foto tutte con la stessa impostazione di bilanciamento del bianco. In tal caso, l'applicazione può specificare il flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK . Il driver della fotocamera garantisce che le informazioni sul bilanciamento del bianco non cambino tra le diverse foto.
Recupero della proprietà
Quando si 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_VIDEOPROC edizione Standard TTING) |
| Risultato | 0 |
| Funzionalità | KSCAMERA_EXTENDEDPROP_C piattaforma di strumenti analitici_ASYNCCONTROL OR con (modalità di elaborazione video supportata) |
| Flag | Modalità di elaborazione video corrente. |
Se in precedenza non è stata impostata alcuna modalità di bilanciamento del bianco, il driver imposta Flag su KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (impostazione predefinita). I membri della struttura KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING che seguono KSCAMERA_EXTENDEDPROP_HEADER vengono impostati in base ai requisiti della modalità di elaborazione.
Impostazione della proprietà
Quando la proprietà è impostata, una richiesta KSPROPERTY_TYPE_edizione Standard T, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER conterrà la modalità di bilanciamento del bianco da impostare. Il membro VideoProc.Value di KSCAMERA_EXTENDEDPROP_VIDEOPROC edizione Standard TTING deve essere ignorato quando Flags contiene il flag della modalità KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.
Requisiti
Versione: disponibile a partire da Windows 8.1
Intestazione: ksmedia.h (include Ksmedia.h)