KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Struktur (ksmedia.h)

Artikel
04/01/2024

Die KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING ist eine Nutzlaststruktur der Eigenschaft für Videoverarbeitungseinstellungen im Zusammenhang mit Weißabgleich, Belichtungsmodus und Fokusmodus.

Syntax

typedef struct tagKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING {
  ULONG                       Mode;
  LONG                        Min;
  LONG                        Max;
  LONG                        Step;
  KSCAMERA_EXTENDEDPROP_VALUE VideoProc;
  ULONGLONG                   Reserved;
} KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, *PKSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING;

Member

Mode

Der Videoverarbeitungsmodustyp. Derzeit wird dieses Element verwendet, um den Weißabgleich zu steuern. Die möglichen Werte für Modus sind die folgenden:

Wert	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE	Ein Bildtemperaturwert wird verwendet, um den Weißabgleich in Grad Kelvin festzulegen.
KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET	Die Weißabgleicheinstellung ist ein voreingestellter Wert, der in VideoProc angegeben wird.

Dieses Element wird nicht für KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE und KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE verwendet. In diesen Fällen muss sie auf 0 festgelegt werden.

Min

Der Mindestbereichswert für die Einstellung in VideoProc.

Max

Der maximale Bereichswert für die Einstellung in VideoProc.

Step

Die Inkrementierung im Wert, falls zutreffend, für die Einstellung in VideoProc , wenn Modus auf KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE festgelegt ist.

Oder

Die Inkrementierung im Wert, falls zutreffend, für die Einstellung in VideoProc beim Festlegen der Belichtung wird manuell mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL festgelegt.

VideoProc

Wenn mit der KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE-Eigenschaftmode auf KSCAMERA_EXTENDEDPROP_WHITEBALANCE_PRESET festgelegt ist, ist der VideoProc.Value.ul-Wert einer der folgenden:

Wert	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_WBPRESET_CLOUDY	Weißabgleich für wolkige Bedingungen voreingestellt.
KSCAMERA_EXTENDEDPROP_WBPRESET_DAYLIGHT	Weißabgleich voreingestellt für trübes Tageslicht.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLASH	Voreingestellter Weißabgleich zum Ausgleich der Blitzbeleuchtung.
KSCAMERA_EXTENDEDPROP_WBPRESET_FLUORESCENT	Voreingestellter Weißabgleich, um fluoreszierende Beleuchtung zu kompensieren.
KSCAMERA_EXTENDEDPROP_WBPRESET_TUNGSTEN	Voreingestellter Weißabgleich, um die ausgelassene Wolframbeleuchtung zu kompensieren.
KSCAMERA_EXTENDEDPROP_WBPRESET_CANDLELIGHT	Weißabgleich voreingestellt, um kerzenscheinend zu kompensieren.

Bei Verwendung der KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE-Eigenschaft ist der VideoProc.Value.ul-Wert ein Temperaturwert in Grad Kelvin, wenn Mode auf KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE festgelegt ist.

Bei Verwendung der KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE-Eigenschaft ist der VideoProc.Value.ul-Wert bei verwendung zum manuellen Festlegen der Belichtung KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL die Belichtungszeit in 100 Nanosekundeneinheiten.

Mit der KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE-Eigenschaft enthält dieses Element den Brennweitenwert für den manuellen Fokusmodus, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL.

Reserved

Reserviert.