KSPROPERTY_CAMERACONTROL_EXTENDED_FOCUSMODE
Die Fokusmoduseigenschaft steuert die auto-, manuellen und voreingestellten Fokusmodi der Kamera.
Nutzungszusammenfassungstabelle
| Herunterladen | Set | Ziel | Eigenschaftsdeskriptortyp | Eigenschaftswerttyp |
|---|---|---|---|---|
Yes |
Yes |
Filter |
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 Size-Element von KSCAMERA_EXTENDEDPROP_HEADER ist auf diese Gesamtdatengröße der Eigenschaft festgelegt.
Der Funktionsmembervon KSCAMERA_EXTENDEDPROP_HEADER enthält eine bitweise OR-Kombination aus einer oder mehreren der folgenden Videoverarbeitungsoptionen.
| Verarbeitungs- und Fokusmodus | BESCHREIBUNG |
|---|---|
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO | Der Kameratreiber verwendet eine eigene Verarbeitungslogik für Videos. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL | Der Kameratreiber verwendet eine voreingestellte Verarbeitungsmethode oder eine temperaturbasierte Methode. |
| KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK | Die aktuelle Videoverarbeitungsmethode ist gesperrt. |
| KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS | Kein konvergierenden Fokuspunkt festgelegt. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO | Fokuskonververzung des Makrobereichs. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL | Normalbereichskonververzung. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE | Vollbereichskonververzung. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY | Fokuskonververzung mit unendlichem Bereich. |
| KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL | Hyperfokalbereich. |
Das Flags-Elementvon KSCAMERA_EXTENDEDPROP_HEADER enthält das Videoverarbeitungsflag, das derzeit für die Kamera festgelegt ist. Wenn KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO Einstellung mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK kombiniert werden kann.
Dieses Eigenschaftssteuerelement ist asynchron und kann abgebrochen werden.
Hinweise
Verarbeitungsmodi
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO
Dieses Flag gibt an, dass der Autofokusvorgang beim Auslösen des Vervollständigungsereignisses konvergiert wurde. Nach Abschluss und wenn dieses Flag nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK kombiniert wird, kann der Fokus abweichen, und der Kameratreiber versucht möglicherweise weiterhin eine Konvergenz. Wenn das KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK-Flag enthalten ist, wird der Fokus für die erste Konvergenz gesperrt und ändert sich erst, wenn ein neuer Fokusbefehl empfangen wird.
Durch Sperren ohne Kombination des Automodus sollte ein bereits gesperrtes Steuerelement vom Kameratreiber als Nichtbetrieb behandelt werden. Durch Sperren in Kombination mit dem Automodus sollte ein bereits gesperrtes Steuerelement eine neue Konvergenz auslösen.
Dieses Flag schließt sich gegenseitig mit den KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL- und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS-Flags aus.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL
Manuell gibt an, dass für diese Videoverarbeitung die spezifischen Werte angegeben werden. Dem Treiber werden bestimmte Werte bereitgestellt.
Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK oder KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK
Wenn dieses Flag ohne ein entsprechendes KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO-Flag festgelegt wird, wird erwartet, dass der Kameratreiber den aktuellen Fokuszustand sperrt und das Vervollständigungsereignis auslöst, sobald der Fokus gesperrt ist. Der Kameratreiber darf den Fokuszustand erst ändern, wenn ein neuer Fokusbefehl empfangen wird. Wenn KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO dieses Flag kombiniert, konvergiert der Kameratreiber beim Automatischfokus, sperrt den Fokus auf diesen konvergenten Punkt und löst dann das Vervollständigungsereignis aus. Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS oder KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL kombiniert werden.
Dieses Flag kann nicht mit einem Bereichsflag für das Fokussteuerelement angegeben werden, es sei denn, es wird mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO kombiniert. In diesem Fall wird der Fokus mithilfe des Bereichsflags ausgeführt, um zu bestimmen, wo der autofokussierte Scan versucht werden soll. Anschließend werden bei Konvergenz die Fokuseinstellung gesperrt, und das Abschlussereignis wird ausgelöst.
KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS
Dieses Flag gibt an, dass der Fokus kontinuierlich ist. In diesem Fall gibt es keinen einzigen Konvergenzpunkt für die Fokussteuerung. Der Treiber muss diese Anforderung akzeptieren und den asynchronen Vorgang sofort abschließen.
Dieses Flag darf nicht mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK oder KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_MANUAL kombiniert werden.
Dieser Modus ist für alle Treiber erforderlich.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_MACRO
Dieses Flag gibt an, dass die Fokuskonververz für den Makrobereich ausgeführt werden soll. Der genaue Brennbereich wird vom Treiber bestimmt. Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_NORMAL
Dieses Flag gibt an, dass die Fokuskonververz für den normalen Bereich ausgeführt werden soll. Der genaue Brennbereich wird vom Treiber bestimmt. Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE
Dieses Flag gibt an, dass die Fokuskonververz für den gesamten Bereich ausgeführt werden soll. Der genaue Brennbereich wird vom Treiber bestimmt. Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
Dieser Modus ist für alle Treiber erforderlich.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_INFINITY
Dieses Flag gibt an, dass die Fokuskonververz für den unendlichen Bereich ausgeführt werden soll. Der genaue Brennbereich wird vom Treiber bestimmt. Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_HYPERFOCAL
Dieses Flag gibt an, dass die Fokuskonververz für den hyperfokalen Bereich ausgeführt werden soll. Der genaue Brennbereich wird vom Treiber bestimmt. Dieses Flag kann mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO und KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS kombiniert werden.
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_VIDEOPROCSETTING) |
| Ergebnis | 0 |
| Funktion | KSCAMERA_EXTENDEDPROP_CAPS_ASYNCCONTROL | KSCAMERA_EXTENDEDPROP_CAPS_CANCELLABLE | (Videoverarbeitungs- und Fokusmodi werden unterstützt) |
| Flags | Der aktuelle Videoverarbeitungs- und Fokusmodus. |
Wenn zuvor kein Fokusbereichsflag festgelegt wurde, legt der Treiber Flags zusammen mit KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO (Standard) auf KSCAMERA_EXTENDEDPROP_FOCUS_RANGE_FULLRANGE fest. Die Elemente der KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING Struktur, die KSCAMERA_EXTENDEDPROP_HEADER folgt, werden entsprechend den Anforderungen des Fokusmodus festgelegt.
Der VideoProp.Value.ull-Wert muss die aktuelle Belichtungseinstellung enthalten, wenn der Modus KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO ist.
Festlegen der Eigenschaft
Wenn die -Eigenschaft festgelegt ist, eine KSPROPERTY_TYPE_SET Anforderung, enthält das Flags-Element von KSCAMERA_EXTENDEDPROP_HEADER den festzulegenden Fokusmodus. Das VideoProc.Value-Element von KSCAMERA_EXTENDEDPROP_VIDEOPROCSETTING muss ignoriert werden, wenn Flags die flags KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_AUTO, KSCAMERA_EXTENDEDPROP_VIDEOPROCFLAG_LOCK, KSCAMERA_EXTENDEDPROP_FOCUS_CONTINUOUS enthält.
Requirements (Anforderungen)
Version |
Verfügbar ab Windows 8.1. |
Header |
Ksmedia.h (include Ksmedia.h) |
Weitere Informationen
Feedback
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 unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für