KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (sottomode)

  • Articolo

La proprietà KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE consente la configurazione di un sottomode.

Riepilogo utilizzo

Di seguito sono definite le sottomodese seguenti.

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE viene usato da una sequenza di foto regolare.

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE viene usato per indicare che una sequenza di foto è variabile. Se vengono specificate le impostazioni per frame, il flag di KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE verrà specificato nel campo sottomode della struttura KSCAMERA_EXTENDEDPROP_PHOTOMODE per indicare una sequenza di foto variabile, anche se non vengono specificate impostazioni di elemento (numero di elementi è 0 per tutti i fotogrammi). Quando il conteggio dei fotogrammi è 1 e il conteggio degli elementi è 0, la sequenza di foto variabile viene ridotta a una sequenza di foto di fotogrammi usando le impostazioni globali.

Di seguito è riportata una definizione della struttura KSCAMERA_EXTENDEDPROP_PHOTOMODE definita in ksmedia.h:

typedef struct tagKSCAMERA_EXTENDEDPROP_PHOTOMODE {  
    ULONG       RequestedHistoryFrames;  
    ULONG       MaxHistoryFrames;  
    ULONG       SubMode;  
    ULONG       Reserved;  
} KSCAMERA_EXTENDEDPROP_PHOTOMODE, *PKSCAMERA_EXTENDEDPROP_PHOTOMODE;

La modalità sequenza di foto variabile presenta le seguenti caratteristiche uniche in una sequenza di foto.

  • Usare sempre una sequenza di foto finite.

  • Quando il conteggio dei fotogrammi è maggiore di 0, vengono applicate le impostazioni del frame.

  • Il driver arresterà automaticamente la sequenza di foto alla fine senza la necessità del trigger KS_VideoControlFlag_StopPhotoSequenceCapture quando viene specificato un numero di cicli maggiore di 0.

  • L'ultimo esempio deve essere contrassegnato con il flag di KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE.

  • La pipeline di acquisizione non rilascia alcun esempio dal driver.

  • Né la pipeline né il driver\MFT0 genera alcuna anteprima fotografica.

Questa proprietà è asincrona e non annullabile.

Requisiti

Intestazione: Ksmedia.h (includere Ksmedia.h)