Freigeben über


KSPROPERTY_CAMERACONTROL_EXTENDED_EXPOSUREMODE

Die "exposure control" Eigenschaft gibt an, ob die automatische Verarbeitung für die Belichtung erfolgt oder ob stattdessen ein manueller Zeitwert verwendet wird.

Übersichtstabelle zur Verwendung

Abrufen Festlegen Ziel Typ des Eigenschaftsdeskriptors Typ des Eigenschaftswertes
Ja Ja Filter KSPROPERTY KSCAMERA_EXTENDEDPROP_HEADER

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

Die Gesamtgröße der Eigenschaftsdaten ist sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING). Das Element Size von KSCAMERA_EXTENDEDPROP_HEADER wird auf diese Gesamtgröße der Eigenschaftsdaten festgelegt.

Der Capability-Element von KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Verknüpfung von einer oder mehreren der folgenden Videoverarbeitungsoptionen.

Verarbeitungsmodus Beschreibung
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO Der Kameratreiber verwendet seine eigene Verarbeitungslogik für Video.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL Der Kameratreiber verwendet eine voreingestellte Verarbeitungsmethode.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK Die aktuelle Videoverarbeitungsmethode ist gesperrt.

Das Flags-Mitglied von KSCAMERA_EXTENDEDPROP_HEADER enthält das Flag für die Videoverarbeitung, das derzeit für die Kamera festgelegt ist. Die Einstellung KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK kombiniert werden.

Diese Eigenschaft ist asynchrones Steuerelement und kann abgebrochen werden.

Hinweise

Verarbeitungsmodi

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO

Dies zeigt an, dass die automatische Verarbeitung unterstützt wird. Der Treiber wird seine interne Logik verwenden, um die Videoverarbeitung zu optimieren. Bei einer KSPROPERTY_TYPE_GET-Anfrage muss das VideoProc-Mitglied von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING den vom Treiber festgelegten aktuellen Wert für die Videoverarbeitung enthalten.

Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK als bitweiser OR-Wert kombiniert werden.

Sperren, ohne Kombination mit dem Automodus, ein bereits gesperrtes Steuerelement sollte vom Kameratreiber als no-op behandelt werden. Sperren, in Kombination mit dem Automodus, sollte ein bereits gesperrtes Steuerelement eine neue Konvergenz auslösen.

Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL kombiniert werden.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL

Manual zeigt an, dass für diese Videoverarbeitung die spezifischen Werte bereitgestellt werden. Spezifische Werte werden dem Treiber zur Verfügung gestellt.

Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO oder KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK kombiniert werden.

KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK

Das Flag für die Option lock zeigt an, dass die aktuelle Videoverarbeitung auf den aktuell programmierten Wert festgelegt ist. Eine Anwendung kann zum Beispiel den Automodus anfordern, bis eine bestimmte Belichtung festgelegt ist. Zu diesem Zeitpunkt wird die Anwendung entscheiden, eine Sequenz von Fotos mit derselben Belichtung aufzunehmen. In einem solchen Fall kann die Anwendung das Flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK angeben.

Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL kombiniert werden.

Abrufen der Eigenschaft

Bei der Reaktion auf eine KSPROPERTY_TYPE_GET-Anfrage legt der Treiber die Mitglieder des KSCAMERA_EXTENDEDPROP_HEADER wie folgt fest.

Member Wert
Version 1
PinId KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF)
Size sizeof(KSCAMERA_EXTENDEDPROP_HEADER) + sizeof(KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING)
Ergebnis 0
Funktion KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL bitweises OR mit (Videoverarbeitungsmodus wird unterstützt)
Flags Der aktuelle Videoverarbeitungsmodus

Wenn zuvor kein Belichtungsmodus festgelegt wurde, setzt der Treiber Flags auf KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (Standard). Die Mitglieder der Struktur KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING, die auf KSCAMERA_EXTENDEDPROP_HEADER folgt, werden entsprechend den Anforderungen des Verarbeitungsmodus festgelegt.

Der Wert VideoProp.Value.ull muss die aktuelle Belichtungseinstellung enthalten, wenn der Modus KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO ist.

Festlegen der Eigenschaft

Wenn die Eigenschaft festgelegt wird, eine KSPROPERTY_TYPE_SET-Anfrage, enthält das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Belichtungsmodus. Der VideoProc.Value-Element von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING muss ignoriert werden, wenn Flags das Modus-Flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO enthält.

Anforderungen

Version: Verfügbar ab Windows 8.1

Header: ksmedia.h (include Ksmedia.h)

Weitere Informationen

KSCAMERA_EXTENDEDPROP_HEADER

KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING