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 |
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) |