KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS ist eine Eigenschafts-ID, die es Kameratreibern ermöglicht, mehrere feste Sichtfeldeinstellungen (FoV) anzubieten, die Benutzer über die Kameraeinstellungsseite oder über Anwendungen auswählen können.
Das im KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS-Nutzlastarray gemeldete Feld der Ansichtswerte muss in absteigender Reihenfolge sortiert werden, z. B. den größten Wert zuerst.
Alle von KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS gemeldeten Field of View (FoV)-Werte müssen für alle verfügbaren Medientypen unterstützt werden, die der Treiber unterstützt.
Treiber können eine Skalierung und/oder ein Zuschneiden vornehmen, um FOVs bei bestimmten Auflösungen zu erzielen.
Ausnahmen können gemacht werden, indem Kameraprofile unterstützt und KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2 als BlockedControl hinzugefügt werden. Dies führt dazu, dass das FIELDOFVIEW2-Steuerelement überhaupt nicht unterstützt wird, wenn ein Profil verwendet wird, das es blockiert.
Übersichtstabelle zur Verwendung
| Bereich | Abrufen | Festlegen | Control | type |
|---|---|---|---|---|
| Version 1 | Ja | No | Filter | Synchron |
KSCAMERA_EXTENDEDPROP_HEADER-Strukturfelder
Die folgende Tabelle enthält die Anforderungen für die KSCAMERA_EXTENDEDPROP_HEADER-Strukturfelder bei Verwendung des Steuerelements.
| Member | Beschreibung |
|---|---|
| Version | Muss 1 sein. |
| PinId | KSCAMERA_EXTENDEDPROP_FILTERSCOPE (0xFFFFFFFF) |
| Size | Dies muss sizeof(KSCAMERA_EXTENDEDPROP_HEADER)+sizeof(KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS) sein. |
| Ergebnis | Muss 0 enthalten. Dieses Feld wird nur verwendet, um die Ergebnisse des letzten asynchronen SET-Vorgangs zurückzugeben. |
| Funktion | Muss den Wert 0 (null) haben. |
| Flags | Muss den Wert 0 (null) haben. |
KSPROPERTY_CAMERACONTROL_EXTENDED_FIELDOFVIEW2_CONFIGCAPS-Payload
Die auf die Headerstruktur folgende Payload ist die obligatorische KSCAMERA_EXTENDEDPROP_FIELDOFVIEW2_CONFIGCAPS.
| Parameter | Beschreibung |
|---|---|
| DefaultDiagonalFieldOfViewInDegrees | Der Field of View (FoV)-Standardwert. Muss einer der im DiscreteFoVStops-Array gemeldeten Werte sein. |
| DiscreteFoVStopsCount | Anzahl der gültigen Einträge in DiscreteFovStops, maximal 360, mindestens 1. |
| DiscreteFoVStops | Array gültiger Field of View (FoV)-Stopps, nur DiscreteFoVStopsCount sind gültige Elemente. |
| Reserviert | Legen Sie auf 0 fest. |
Anforderungen
Mindestens unterstützter Client: Windows 11, Version 24H2
Header: ksmedia.h (include Ksmedia.h)