Freigeben über


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