KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE

La proprietà modalità messa a fuoco controlla le modalità di messa a fuoco automatica, manuale e predefinita della fotocamera.

Tabella riepilogo utilizzo

Il valore della proprietà (dati dell'operazione) contiene una struttura KSCAMERA_EXTENDEDPROP_HEADER e una struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING .

Le dimensioni totali dei dati della proprietà sono sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). 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 opzioni di elaborazione video seguenti.

Il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER contiene il flag di elaborazione video attualmente impostato per la fotocamera. Se KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO'impostazione può essere combinata con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK.

Questo controllo proprietà è asincrono e annullabile.

Commenti

Modalità di elaborazione

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

Questo flag indica che l'operazione di messa a fuoco automatica è convergente quando viene attivato l'evento di completamento. Al termine, e quando questo flag non è combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK, lo stato attivo può divergere e il driver della fotocamera può continuare a tentare la convergenza. Se il flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK è incluso, lo stato attivo viene bloccato alla prima convergenza e non cambia finché non viene ricevuto un nuovo comando di stato attivo.

Il blocco, 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.

Questo flag si escludono a vicenda con i flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

Manuale indica che per l'elaborazione video vengono forniti i valori specifici. I valori specifici vengono forniti al driver.

Questo flag non deve essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK o KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

Quando questo flag viene impostato senza un flag di KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO corrispondente, il driver della fotocamera dovrebbe bloccare lo stato attivo corrente e attivare l'evento di completamento dopo che lo stato attivo è bloccato. Il driver della fotocamera non deve variare lo stato attivo fino a quando non viene ricevuto un nuovo comando di stato attivo. Se KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO combinato questo flag, il driver della fotocamera convergerà sullo stato attivo automatico e bloccherà lo stato attivo su tale punto convergente e quindi attiverà l'evento di completamento. Questo flag non deve essere combinato con KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS o KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Questo flag potrebbe non essere specificato con un flag di intervallo per il controllo dello stato attivo, a meno che non venga combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO. In tal caso, lo stato attivo viene eseguito usando il flag di intervallo per determinare dove tentare l'analisi dello stato attivo automatico. Quindi, al momento della convergenza, l'impostazione dello stato attivo viene bloccata e viene attivato l'evento di completamento.

KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS

Questo flag indica che lo stato attivo è continuo. In questo caso non esiste un singolo punto di convergenza per il controllo dello stato attivo. Il driver deve accettare questa richiesta e completare immediatamente l'operazione asincrona.

Questo flag non deve essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK o KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Questa modalità è necessaria per tutti i driver.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO

Questo flag indica che è necessario eseguire la convergenza dello stato attivo per l'intervallo di macro. L'intervallo focale esatto è determinato dal conducente. Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL

Questo flag indica che la convergenza dello stato attivo deve essere eseguita per l'intervallo normale. L'intervallo focale esatto è determinato dal conducente. Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE

Questo flag indica che la convergenza dello stato attivo deve essere eseguita per l'intervallo completo. L'intervallo focale esatto è determinato dal conducente. Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

Questa modalità è necessaria per tutti i driver.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY

Questo flag indica che la convergenza dello stato attivo deve essere eseguita per l'intervallo infinito. L'intervallo focale esatto è determinato dal conducente. Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL

Questo flag indica che la convergenza dello stato attivo deve essere eseguita per l'intervallo iperfocale. L'intervallo focale esatto è determinato dal conducente. Questo flag può essere combinato con KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO e KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

Recupero della proprietà

Quando risponde a una richiesta di KSPROPERTY_TYPE_GET, il driver imposta i membri del KSCAMERA_EXTENDEDPROP_HEADER su quanto segue.

Se in precedenza non è stato impostato alcun flag di intervallo di stato attivo, il driver imposta Flag su KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE insieme a KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (impostazione predefinita). I membri della struttura KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING che segue KSCAMERA_EXTENDEDPROP_HEADER vengono impostati in base ai requisiti della modalità messa a fuoco.

Il valore VideoProp.Value.ull deve contenere l'impostazione di esposizione corrente quando la modalità è KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO.

Impostazione della proprietà

Quando la proprietà è impostata, una richiesta di KSPROPERTY_TYPE_SET, il membro Flags di KSCAMERA_EXTENDEDPROP_HEADER conterrà la modalità messa a fuoco da impostare. Il membro VideoProc.Value di KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING deve essere ignorato quando Flags contiene i flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS.

Requisiti

Vedi anche

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING