KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE (Untermodus)

Mit der eigenschaft KSPROPERTY_CAMERACONTROL_EXTENDED_PHOTOMODE kann ein Untermodus konfiguriert werden.

Nutzungszusammenfassung

Die folgenden Untermoden werden wie folgt definiert.

#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE       0x00000000
#define KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE   0x00000001

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_NONE wird von einer regulären Fotosequenz verwendet.

KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE wird verwendet, um anzugeben, dass eine Fotosequenz variabel ist. Wenn Einstellungen pro Frame angegeben werden, wird das flag KSCAMERA_EXTENDEDPROP_PHOTOMODE_SEQUENCE_SUB_VARIABLE im Untermodusfeld der KSCAMERA_EXTENDEDPROP_PHOTOMODE-Struktur angegeben, um eine variable Fotosequenz anzugeben, auch wenn keine Elementeinstellungen angegeben sind (Elementanzahl ist 0 für alle Frames). Wenn die Frameanzahl 1 und die Elementanzahl 0 ist, reduziert sich die variable Fotosequenz mithilfe globaler Einstellungen auf eine bildvariable Fotosequenz.

Es folgt eine Definition der in ksmedia.h definierten KSCAMERA_EXTENDEDPROP_PHOTOMODE-Struktur:

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

Der variable Fotosequenzmodus weist die folgenden eindeutigen Merkmale einer Fotosequenz auf.

  • Verwenden Sie immer eine endliche Fotosequenz.

  • Einstellungen pro Frame werden angewendet, wenn die Frameanzahl größer als 0 ist.

  • Der Treiber beendet automatisch die Fotosequenz am Ende, ohne dass der KS_VideoControlFlag_StopPhotoSequenceCapture Trigger erforderlich ist, wenn eine Schleifenanzahl größer als 0 angegeben wird.

  • Das letzte Beispiel muss mit dem flag KSSTREAM_HEADER_OPTIONSF_ENDOFPHOTOSEQUENCE gekennzeichnet werden.

  • Die Erfassungspipeline verlöscht keine Stichproben aus dem Treiber.

  • Weder die Pipeline noch der Treiber\MFT0 generiert eine Fotominiaturansicht.

Diese Eigenschaft ist asynchron und kann nicht abgebrochen werden.

Anforderungen

Header: Ksmedia.h (einschließlich Ksmedia.h)