KSPROPERTY_CAMERACONTROL_EXTENDED_WHITEBALANCEMODE
Die Eigenschaft weißabgleichsmodus gibt an, ob die automatische Verarbeitung für den Weißabgleich erfolgt oder stattdessen ein manueller Temperaturwert verwendet wird.
Nutzungszusammenfassungstabelle
Herunterladen | Set | Ziel | Eigenschaftendeskriptortyp | Eigenschaftswerttyp |
---|---|---|---|---|
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). Der Size-Member von KSCAMERA_EXTENDEDPROP_HEADER wird auf diese Gesamtgröße der Eigenschaftsdaten festgelegt.
Der Capability-Member von KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus einer oder mehreren der folgenden Videoverarbeitungsoptionen.
Verarbeitungsmodus | BESCHREIBUNG |
---|---|
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Der Kameratreiber verwendet eine eigene Verarbeitungslogik für Video. |
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Der Kameratreiber verwendet eine voreingestellte Verarbeitungsmethode oder eine temperaturbasierte Methode. |
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | Die aktuelle Videoverarbeitungsmethode ist gesperrt. |
Das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER enthält das Videoverarbeitungsflag, das derzeit für die Kamera festgelegt ist. Die einstellung KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK kombiniert werden.
Dieses Eigenschaftensteuerelement ist asynchron und kann nicht abgebrochen werden.
Bemerkungen
Verarbeitungsmodi
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Dies gibt an, dass die automatische Verarbeitung unterstützt wird. Der Treiber verwendet seine interne Logik, um die Videoverarbeitung zu optimieren. Für eine KSPROPERTY_TYPE_GET-Anforderung muss das VideoProc-Element von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING den aktuellen treiberbestimmten Wert für die Videoverarbeitung enthalten. Im Fall des Weißabgleichs muss er die aktuelle Temperatur in Kelvin enthalten. Das Mode-Element wird für den automatischen Vorgang ignoriert.
Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK als bitweisen OR-Wert kombiniert werden. Wenn er gesperrt ist, besteht das erwartete Verhalten des Kameratreibers darin, den Weißabgleich zu konvergieren und den Weißabgleichswert mit dem konvergenten Wert zu sperren, und nicht erneut zu versuchen, den automatischen Weißabgleich durchzuführen, bis ein neuer Weißabgleichsbefehl empfangen wird.
Beim Sperren ohne Kombination des Automodus sollte ein bereits gesperrtes Steuerelement vom Kameratreiber als No-Op behandelt werden. Durch sperren in Kombination mit dem Auto-Modus sollte ein bereits gesperrtes Steuerelement eine neue Konvergenz auslösen.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manuell gibt an, dass für diese Videoverarbeitung die spezifischen Werte angegeben werden. Wenn der Mode-Member von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING im Fall des Weißabgleichs KSCAMERA_EXTENDEDPROP_WHITEBALANCE_TEMPERATURE angibt, enthält VideoProc.Value.ul den Temperaturwert in Grad Kelvin.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK Das Sperroptionsflag gibt an, dass die aktuelle Videoverarbeitung an den aktuell programmierten Wert gebunden ist. Beispielsweise kann eine Anwendung den automatischen Modus anfordern, bis ein bestimmter Weißabgleich bestimmt wird. An diesem Punkt entscheidet sich die Anwendung, eine Sequenz von Fotos mit der gleichen Weißabgleichseinstellung aufzunehmen. In diesem Fall kann die Anwendung das flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK angeben. Der Kameratreiber stellt sicher, dass sich die Weißabgleichsinformationen für die verschiedenen Fotos nicht ändern.
Abrufen der Eigenschaft
Wenn er auf eine KSPROPERTY_TYPE_GET-Anforderung antwortet, legt der Treiber die Member 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 OR'd mit (Unterstützter Videoverarbeitungsmodus) |
Flags | Der aktuelle Videoverarbeitungsmodus. |
Wenn zuvor kein Weißabgleichsmodus festgelegt wurde, legt der Treiber Flags auf KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (Standard) fest. Die Member der KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING-Struktur , die KSCAMERA_EXTENDEDPROP_HEADER folgt, werden entsprechend den Anforderungen des Verarbeitungsmodus festgelegt.
Festlegen der -Eigenschaft
Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET-Anforderung, enthält der Flags-Member von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Weißabgleichsmodus. Das VideoProc.Value-Element von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING muss ignoriert werden, wenn Flags das Flag KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO Modus enthält.
Anforderungen
Version: Verfügbar ab Windows 8.1
Header: ksmedia.h (include Ksmedia.h)
Weitere Informationen
Feedback
https://aka.ms/ContentUserFeedback.
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unterFeedback senden und anzeigen für