KSPROPERTY_CAMERACONTROL_EXTENDED_TORCHMODE

Der Taschenlampenmodus bestimmt, wie der Blitz einer Kamera bei schlechten Lichtverhältnissen verwendet wird. Durch den Blitz wird kontinuierlich eine Lichtquelle mit geringerer Intensität bereitgestellt, um ausreichend Licht für Vorgänge wie den Autofokus zu ermöglichen.

Nutzungszusammenfassungstabelle

Herunterladen	Set	Ziel	Eigenschaftsdeskriptortyp	Eigenschaftswerttyp
Yes	Yes	Filter	KSPROPERTY	KSCAMERA_EXTENDEDPROP_HEADER

Der Eigenschaftswert (Vorgangsdaten) enthält eine KSCAMERA_EXTENDEDPROP_HEADER Struktur und eine KSCAMERA_EXTENDEDPROP_VALUE Struktur.

Die Gesamtgröße der Eigenschaftsdaten ist sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE). Das Size-Element von KSCAMERA_EXTENDEDPROP_HEADER ist auf diese Gesamtdatengröße der Eigenschaft festgelegt.

Das Funktionselementvon KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus einem oder mehreren der folgenden Taschenlampenmodi, die vom Treiber unterstützt werden.

Taschenlampenmodus	BESCHREIBUNG
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF	Taschenlampe ist ausgeschaltet.
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON	Das Taschenlampenlicht ist auf der Standardmäßigen Intensitätsstufe aktiviert.
KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER	Taschenlampe ist mit einer bestimmten Leistungsstufe eingeschaltet.

Das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER enthält den derzeit für die Kamera festgelegten Taschenlampenmodus. Der Standardmodus für eine Kamera ist KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF, und der Treiber muss diesen Taschenlampenmodus unterstützen.

Dieses Eigenschaftssteuerelement ist synchron und nicht abbruchfähig.

Hinweise

Abrufen der Eigenschaft

Wenn er auf eine KSPROPERTY_TYPE_GET-Anforderung antwortet, legt der Treiber die Member der KSCAMERA_EXTENDEDPROP_HEADER wie folgt fest.

Mitglied	Wert
Version	1
PinId	KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF).
Size	sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VALUE)
Ergebnis	0
Funktion	Werte im Taschenlampenmodus werden unterstützt.
Flags	Die aktuelle Einstellung des Taschenlampenmoduswerts (nur ein Wert).

Wenn der Taschenlampenmodus KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER ist, enthält das Value.ull-Element von KSCAMERA_EXTENDEDPROP_VALUE einen Intensitätsgradwert zwischen 0 und 100. Eine Intensität von 0 gibt einen Minimalpegel und eine Intensität von 100 einen maximalen Intensitätsgrad an.

Wenn zuvor kein Szenenmodus festgelegt wurde, wird Flags auf KSCAMERA_EXTENDEDPROP_VIDEOTORCH_OFF (Standard) festgelegt.

Festlegen der Eigenschaft

Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET Anforderung, enthält das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Taschenlampenmodus. Das Value.ull-Element von KSCAMERA_EXTENDEDPROP_VALUE enthält die Intensitätsstufe, die festgelegt werden soll, wenn Flags KSCAMERA_EXTENDEDPROP_VIDEOTORCH_ON_ADJUSTABLEPOWER ist.

Requirements (Anforderungen)

Version	Verfügbar ab Windows 8.1.
Header	Ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE