KSPROPERTY_CAMERACONTROL_EXTENDED_SCENEMODE (vom Treiber definierter Modus)
Die Szenenmoduseigenschaft wählt einen vom Treiber definierten Modus aus, der eine Sammlung von voreingestellten Steuerelementen darstellt. Der Treiber bestimmt die Voreinstellungen, die einem Szenenmodus zugewiesen sind, und aktiviert diese Steuerungseinstellungen, wenn eine Szene ausgewählt wird.
Tabelle "Nutzungszusammenfassung"
| 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 KSCAMERA_EXTENDEDPROP_VALUE ist erforderlich, aber das Value-Element wird ignoriert.
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 Featureelementvon KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus einem oder mehreren der folgenden Szenenmodi, die vom Treiber unterstützt werden.
| Szenenmodus | BESCHREIBUNG |
|---|---|
| KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO | Automatischer Duftmodus. Steuerelemente verfügen über ihre automatischen Einstellungen. |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MACRO | Makroszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_PORTRAIT | Portraitszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SPORT | Sportszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SNOW | Schneeszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHT | Nachtszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BEACH | Strandszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_SUNSET | Sonnenuntergangsszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_CANDLELIGHT | Kerzenscheinszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_LANDSCAPE | Querformatmodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_NIGHTPORTRAIT | Nachtporträt-Szenenmodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_BACKLIT | Hintergrundbeleuchtungsszenemodus (Treiber definiert). |
| KSCAMERA_EXTENDEDPROP_SCENEMODE_MANUAL | Steuerelemente werden manuell geändert, und es werden keine vordefinierten Szenenmodi festgelegt. |
Das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER enthält den derzeit für die Kamera festgelegten Szenenmodus. Der Standardszenemodus für eine Kamera ist immer KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO.
Dieses Eigenschaftensteuerelement ist asynchron und kann nicht abgebrochen werden.
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 | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | (Szenenmoduswerte werden unterstützt) |
| Flags | Die aktuelle Einstellung für den Szenenmoduswert (nur ein Wert) |
Wenn zuvor kein Szenenmodus festgelegt wurde, wird Flags auf KSCAMERA_EXTENDEDPROP_SCENEMODE_AUTO (Standard) festgelegt.
Festlegen der Eigenschaft
Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET Anforderung, enthält das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER den zu aktivierenden Szenenmodus.
Anforderungen
Version: Verfügbar ab Windows 8.1
Header: Ksmedia.h (include Ksmedia.h)