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)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VALUE